





] 


Preface 

What Is the Image Processing Toolbox2? ............... ... Xi 
Related Products .. Xiii 
Configuration Notes .. .5 .. XivV 
About the Documentation ...... .4 XV 
Structure ofthe Documentation .. .9. XV 
[Tinage Greg 二 生生 二 人生 人 区间 和 和 作 放生 和 全 全 全 汪 帮 二 2 XVi 

上 GD 人 全 全 玖 人 和 抽 全 XVii 
MATLAB Newsgroup ...... XViii 
Typographical Conventions ........................... Xi 
Image Processing Demos .............， 和 
Getting Started 

Example 1 一 Some Basic Topics ........................ 1-2 
1.Read and Display an Image .......................... 1-2 

2. Check the Image in Memory .......................... 1-3 

3. Perform Histogram Equalization ...................... 1-4 
本 ET 1-7 

5. Check the Contents ofthe Newly Written File ........... 1-7 
Example2 一 Adqvanced Topics ......................... 1-9 
1.Read and Display an Image .......................... 1-9 

2. Use Morphological Opening to 了 stimate the Background .，1-9 

3. Display the Background Approximation as a Surface . ..….. 1-10 


Contents 





4. Subtract the Background Image from the Original Image . 1-12 


5.Adjust the Image Contrast ............ 1-13 
6. Apply Thresholdqing to the Image ..................... 1-14 
7. Determine the Number of Objects in the Image ......... 1-15 
8. Examine the Label Matrix .. 1-16 
9. Measure Object Properties in the Image ............... 1-18 


10. Compute Statistical Properties of Objects in the Image . . 1-21 





Where to Go from Here ...............， 1-23 
和 的 人生 避 | 罗 人 1-23 
下 opoxsD6 人 0 1-23 

Introduction 

Terminology .. 2-2 


Images in MATLAB and the Imnage Processing Toolbox . .. 2-4 


Storage Classes in the Toolbox .......................... 2-4 
Image Types in the Toolbox ............................ 2-5 
Indqexed Images .. 2-5 
[Intensity TageS 和 二 让 全 证 人 放生 衣 全 和 全 二 全 二 全 训 全 全 人 全 二 训 电 2-7 
有 卫 iary TniageS 人 全 二 生生 全 二 全 人 全 下 训 人 2-8 
有 2-8 
Multiframe Image Arrays .. 2-11 
Summary of Image Types and Numeric Classes ..........， 2-12 
Converting Image Types .. 2-12 
Working with Imnage Data .. .4 2-15 
Reading a Graphics Image .....， 2-16 
Writing a Graphics Image ................ 2-17 
Querying a Graphics File .. 2-18 
Converting Image Storage Classes .....................， 2-19 
Converting Graphics File Formats .. .9 2-20 
Image Arithmetic ... 2-21 


也 Cote72ts 


Summary of Image Arithmetic Functions ................ 2-22 


Image Arithmetic Truncation Rules ....................， 2-22 
交 呈 中 用 大作 贡生 人 让 和 和 二 让 和 相 是 刘 生生 下 二 全 和 和 人 2-23 
Sabracng Jaeeg 2-24 
Multiplying Images .. 2-25 
人 2-27 
Nesting Calls to Image Arithmetic Functions ............， 2-27 
Coordinate Systems .. .5 2-28 
Pixel Coordinates .0 2-28 
Daf 吉 志 OOrd1matG 人 NO 2-29 





3 | 


Terminology .. 3-2 
Displaying Inages .. .0 3-3 
Displaying Indexed Images ..... .9 3-3 
Displaying Intensity Images ..... 3-4 
Displaying Binary Images .. 3-6 
Displaying RGB Images ... .0 3-10 
Displaying Images Directly 人 om Disk ................， 3-11 
Special Display Techniques ........................... 3-12 
六 dding 于 COolorbar 生生 生生 二 二 和 生生 汪 二- 人 人 3-12 
Displaying Multiframe Images ......................... 3-13 
Displaying Mujltiple Imnages ......... 3-17 
Setting Toolbox Display Preferences ................... 3-23 
Toolbox Preferences .. 3-23 
Using the truesize Function .............. 3-24 
Zooming in on aRegion ofan Imnage ..................， 3-26 
Zooming In or Out with the Zoom Buttons ...............， 3-26 
Zooming In or Out from the Command Line .............. 3-26 


ji 


iv 


Cote72ts 


Texture Mapping .. .4 3-28 


Printing Imnages .. .0 3-29 


Troubleshooting .... .ee， 3-30 





4 


GOING 4-2 
9 人 4-3 
Tage:TyDeS 让 人 生生 全 训 和 全 全 和 二 放 全 全 全 卫生 全 二 二 4-4 
Image Resizing .. .ee. 4-5 
Specifying the Size ofthe Output Image .................. 4-5 
Specifying the Interpolation Method ..................... 4-6 
Using Filters to Prevent Aliasing ........................ 4-6 
Image Rotation .. .ee. 4-8 
Specifying the Interpolation Method ..................... 4-8 
Specifying the Size ofthe Output Image .................. 4-9 
Image Cropping ... .ee， 4-10 
Performing General Spatial Transformations ..........， 4-12 
Specifying the Transformation Type ....................， 4-12 
Performing the Transformation .......................， 4-14 
Advanced Spatial Transformation Techniques ............ 4-15 


Image Registration 





D | 


Terminology 


Registering an Image .......... 5-4 


有 60intEMaiD 有 站 区 和 全 全 全 全 生生 总 全 全 和 生生 和 全 生生 全 二 放 刘 训 作 全 全 人 全 六 5-4 
卫 xample: Registering to a Digital Orthophoto .............. 5-6 
Types of Supported Transformations .................. 5-13 
Selecting Control Points .............................. 5-15 
Using the Control Point Selection Tool ..................， 5-15 
Starting the Control Point Selection Tool ................. 5-16 
Viewing the Images .. 5-18 
Specifying Matching Control Point Pairs ................. 5-22 
Saving Control Points .............................， 5-30 
Using Correlation to Inprove Control Points ........... 5-33 


Neighborhood and Block Operations 





oO 


Terminology .. 6-2 
Block Processing Operations ........................... 6-3 
Types of Block Processing Operations ...................， 6-3 
Slidqing Neighborhood Operations ...................... 6-5 
尼 add 识 全 有 ordars 6-6 
Linear and Nonlinear Filtering ..............， 6-6 
Distinct Block Operations ................. 6-9 
人 6-10 
Column Processing ............ 6-12 
Sliding Neighborhoods .. 6-12 


四 1 人 有 CE 肌 10CS 6-13 


Vi 


Linear Filtering and Filter Design 





7 | 





的 攻 人 7-2 
Linear Filtering .. .ee 7-4 
GOnVYOlDtO 闪 全 生生 让 全 生生 的 站 全 生生 7-4 
COTTelatiOi 人生 全 人 全 生 人 本 7-6 
Filtering Using imfilter .. 7-7 
Using Predefined Filter Types .. 7-14 
Jilter DeSigm 全 全 全 攻 居 入 汪 二 二 全 全 全 避 记 二 二 全 人 全 7-16 
和 人 7-16 
Frequency Transformation Method ...............， 7-17 
Frequency Sampling Method .. .9 7-18 
Windowing Method .. 7-19 
Creating the Desired Frequency Response Matrix ......... 7-20 
Computing the Frequency Response of a Filter ............ 7-21 
Transforms 

Terminology .. 8-2 
Fourier Transform .. .ee. 8-3 
Definition of Fourier Transform ......................... 8-3 
Discrete Fourier Transform .......... 8-8 
国有 了 0 本 全 证 入 生生 和 和 放生 太 册 但 生生 人 生 全 作 本 和 8-11 
Discrete Cosine Transform ........................， 8-16 
The DCT Transform Matrix ........... 8-17 
The DCT and Image Compression .....................， 8-18 
Radon Transform ... .ee， 8-20 
Using the Radon Transform to Detect Lines .............. 8-24 
The Inverse Radon Transform ...........， 8-26 


Cote72ts 


Morphological Operations 





9 | 


全 9-2 
Dilation and Erosion .......... 9-4 
Understanding Dilation and Erosion ..................... 9-4 
Structuring Elements .. 9-7 
Dilatng anInaagE 生生 9-11 
Eroding an Imnage .ee 9-12 
Combining Dilation and Erosion ................， 9-14 
Dilation- and Erosion-Based Functions .................， 9-16 
Morphological Reconstruction ........................ 9-19 
Markerand Magk oo 9-19 
Pixel Connectivity ................， 9-23 
Flood-Fill Operations .. 9-26 
Finding Peaks and Valleys .. 9-29 
Distance Transform .........， 9-38 


Example: Marker-Controlled Watershed Segmentation . .9-41 


Step 1: Read in Images .. 9-41 
Step 2: Create the Structuring Element .................. 9-42 
Step 3: Enhance the Image Contrast .................... 9-42 
Step 4: 卫 xaggerate the Gaps Between Objects ...…........， 9-43 
Step 5: Convert Objects of Interest ...................... 9-44 
Step 6: Detect Intensity Valleys ........................ 9-45 
Step 7: Watershed Segmentation ......................， 9-46 
Step 8: 了 xtract Features from Label Matrix .............， 9-47 
Objects, Regions, and Feature Measurement .........….. 9-49 
Connected-Component Labeling .......................， 9-49 
Selecting Objects in a Binary Image ....................， 9-51 
Finding the Area of Binary Images ..........， 9-51 
Finding the Euler Number ofa Binary Image ............， 9-52 
Lookup Table Operations .............， 9-53 


Vii 


Viii Contents 


Analyzing and Enhancing Images 





10 


站 GOD1OE 10-2 
Pixel Values and Statistics .........， 10-3 
Pixel Selection .. 10-3 
1 10-4 
[mage GenitoUre 10-8 
[Tinage HiStogranniee 全 让 扩 攻 全 人 全 攻 放生 全 人 全 人 全 人 全 人 区 证 汪 全 和 10-8 
SUrmnmary 呈 Hat 语 机 人 时 庆生 证 且 二 衣 二 汪 庆 情 是 时 届 刘 汪汪 下 让 是 10-9 
Region Property Measurement ........................，. 10-9 
Image Analysis ... .ee 10-10 
了 dge Detection .. 10-10 
Quadtree Decomposition .. 10-11 
Image 了 Enhancement .. .4 10-14 
Intensity Adjustment .. 10-14 
Noise Removal .. 10-20 





11 


并 人 ROLE 11-2 
Spbecifying a Region of Interest ........................ 11-3 
Selacting 和 卫 Olyggoi 和 全 让 人生 请 放 和 让 11-3 
Other Selection Methods .. 11-4 
Filtering a Region ... .0 11-6 
Filling a Region ... .9 11-8 


Image Deblurring 





12 | 





13 | 


下 ROGER 全 生计 人 和 全 全 信介 的 各 册 全 人 全 12-2 
Understanding Deblurring ..... .9. 12-3 
56680E 电 二 疝 放 攻 让 全 和 站 让 全 和 在 放 让 让 全 二 全 机 和 on 12-3 

有 ebplarmg Wode] 12-3 
Using the Deblurring Functions ....................... 12-5 
Deblurring with the Wiener Filter ...............， 12-6 
Deblurring with a Regularized Filter ................， 12-8 
Deblurring with the Lucy-Richardson Algorithm .........， 12-9 
Deblurring with the Blind Deconvolution Algorithm ...... 12-14 
Creating Your Own Deblurring Functions ..............， 12-19 
Avoiding Ringing in Deblurred Images ................ 12-20 
Color 

Terminology .. 13-2 
Working with Different Screen Bit Depths ............， 13-3 
Determining Your Systems Screen Bit Depth ............， 13-3 
Choosing a Screen Bit Depth .9 13-4 
Reducing the Number of Colors in an Image ............ 13-6 
人 13-7 
Reducing Colors in an Indexed Image .................. 13-12 
有 村 13-13 
Converting to Other Color Spaces .................... 13-15 
NT 全 DR 13-15 
CO 人 全 册 人 生 全 入 放生 语 机 二 刘 仙 全 二 人生 和 全 全 和 全 13-16 
SWOTDRGG 13-16 


ii 


开 


Cote72ts 


Function Reference 





Functions 一 By Category ..... 14-2 
Image Input, Output, and Display ...................... 14-2 
Spatial Transformation and Registration ................. 14-5 
Image Analysis and Statistics .. 14-6 
Image Enhancement and Restoration ................... 14-7 
Linear Filtering and Transforms ....................... 14-8 
Morphological Operations .. .9. 14-10 
Region-Based, Neighborhood, and Block Processing ....... 14-12 
Colormap and Color Space Functions ..................， 14-13 
Miscellaneous Functions .. .9 14-14 

Functions 一 Alphabetical List ..................， 14-16 


Preface 








This section introduces you to the Image Processing Toolbox and describes conventions used by the 


documentation. 


What Is the Image Processing Toolbox?” JIntroduces the Image Processing Toolbox and its 


(p. xii) 
Related Products (p. xiii) 


Configuration Notes (p. Xiv) 


About the Documentation (p. XvV) 


Typographical Conventions (P. Xix) 


Image Processing Demos (p. XX) 


capabilities 

Highlights other MathWorks products that are related to 
image processing 

Provides some information about installing and 


configuring the image processing toolbox 


Details the structure of the Image Processing Toolbox 
documentation and credits the sources ofthe images used 
in the documentation 


Lists typographical conventions used in the 
documentation 


Lists all the demos included with the Image Processing 
Toolbox 
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What ls the Image Processing Toolbox? 


The Image Processing Toolbox is a collection of fanctiongs that extend the 
capability ofthe MATLABQ@numeric computing environment. The toolbox 
Supports a wide range of image processing operations, including: 

se Spatial image transformationgs 

e。 Morphological operationsgs 

e。 Neighborhood and block operationgs 

e Linear filtering and flter design 

e Transforms 

e。 Image analysis and enhancement 

e [Image registration 

e Deblurring 

e Region of interest operationsg 

Many of the toolbox fanctions are MATLAB M-files, a series of MATLAB 


statements that imnplement specialized image processing algorithms. You can 
View the MATLAB code for these functions using the statement 


type TunctIonm_mame 


You can extend the capabilities ofthe Image Processing Toolbox by writing 
your own M-files, or by using the toolbox in combination with other toolboxes， 
Such as the Signal Processing Toolbox and the Wavelet Toolbox. 


For a list of the nevw features in Version 3.0, see the Release Notes 
documentation. 
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Related Producfs 


The MathWorks provides several products that are especially relevant to the 
kinds of tasks you can perform with Image Processing Toolbox. 


For more information about any of these products, see either 


e The online documentation for that product ifit is installed or 计 you are 
reading the documentation 位 om the CD 


e The MathWorks Web site, at http:/1/www.mathworks.com; seethe “products” 


Section 


The toolboxes listed below all include functiongs that extend MATLAB. The 
blocksets all include blocks that extend Simulink. 





Product 


Descripfion 





DSP Blockset 


Mapping Toolbox 


MATLAB 


Signal Processing 
Toolbox 


Wavelet Toolbox 


Design and simulate DSP systems 


Analyze and visualize geographically based 
information 


The Language of Technical Computing 


Perform signal processing, analysis, and 
algorithm development 


Analyze, compress, and denoise Signals and 
images using wavelet techniques 
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Configuraftion Notes 


XivV 


To determine ifthe Image Processing Toolbox is installed on your system, type 
this command at the MATLAB prompt. 


Ver 


When you enter this command, MATLAB displays information about the 
version of MATLAB you are running, including a list of all toolboxes installed 
on your System and their version numbers. 


For information about installing the toolbox, see the MATLAB Installation 
Guide for your platform. 


For the most up-to-date information about system requirements, see the 
System requirements page, available in the products area at The MathWorks 
Web site (www.mathworks .com). 


Abouft the Documentation 





Abouf the Documentafion 


This section: 


e Describes the structure ofthe Image Processing Toolbox documentation 
e Credits the sources of images used in the documentation 


e 了 xplains the use of glossaries at the beginning of each major section of the 
documentation 


e Provides pointers to other sources of information 


Stfrucfure of the Documentaftion 


The documentation is organized into these major sections: 


e Chapter 1“Getting Started”contains two step-by-step examples that will 
help you get started with using the Image Processing Toolbox. 

e Chapter 2“Introduction”introduces the Image Processing Toolbox and its 
capabilities. 

e Chapter 3“Displaying and Printing Images”describes how to display and 
print images in MATLAB. 

e。 Chapter 4，“Spatial Transformations”describes image cropping, resizing， 
rotating, and other geometric transformations you can perform with the 
Image Processing Toolbox. 

e Chapter 5“Image Registration”describes how to align two images ofthe 
same Scene Using the Control Point Selection Tool. 

e Chapter 6 “Neighborhood and Block Operations”describes how to perform 
block operations on images. 

e Chapter 7，Linear Filtering and Filter Design”describes how to create 
在 lters. 

e Chapter 8“Transforms”discusses several imnportant image transforms. 

e Chapter 9,“Morphological Operations”describes the functions in the toolbox 
that you can use to implement morphological image processing operations, 

e。 Chapter 10,“Analyzing and Enhancing Images”discusses working with 


image data and displaying images in MATLAB and the Image Processing 
Toolbox. 


瑟 V 
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e Chapter 11,“Region-Based Processing”describes how to perform image 
processing on Specific regions of an imasge. 


e Chapter 12，“Image Deblurring”describes the toolbox deblurring functions， 
e Chapter 13，“Color”describes hovw to handle color images. 


For detailed reference descriptions ofeach toolbox function, go tothe MATLAB 
Help browser. Many reference descriptions also include examples, a 
description ofthe fonction's algorithm, and references to additional reading 
material. 


Image Credits 


This table lists the copyright owners ofthe images used in the Image 
Processing Toolbox documentation. 





Image Source 





cameraman Copyright Massachusetts Institute of 
Technology Used with permission. 


cel1 Cancer cell from arat's prostate, courtesy of 
Alan W. Partin, M.D., Ph.D., Johns Hopkins 
University School of Medicine. 


Circuit Micrograph of 16-bit A/D converter circuit， 
courtesy of Steve Decker and Shujaat 
Nadeem, MIT 1993. 


concordaerial and Visible color aerial photographs courtesy of 
westconcordaerial mPower3/Emerge. 


concordorthophoto and Orthoregistered photographs courtesy of 
westconcordorthophoto Massachusetts Executive Office of 
Environmental Affairs, MassGIS. 


forest Photograph of Carmanah Ancient Forest， 
British Columbia, Canada, courtesy of Susan 
Cohen. 
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Image Source 

LAN files Permission to use LandsatIM data sets 
provided by Space Imaging, LLC, Denvem 
Colorado. 

m83 M83 spiral galaxy astronomical image 
courtesy of Anglo-Australian Observatory 
photography by David Malin， 

moon Copyright Michael Myers. Used with 
permilsslon , 

trees yees wzit au Viex watercolor and ink on 


paperm copyright Susan Cohen. Used with 
permilsslon , 





In adqdition, the following images are copyrighted: 


J. C.Russ, THPe 717zage Processi15 瑟 anaboop, ThirdEdition, 1998, CRC Press， 
Boca Raton, ISBN 0-8493-2532-3. Used with permission. 
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Terminology 


At the beginning of each chapter (and sometimes at the beginning of a major 
section within a chapter) are tables that serve as glossaries of words you need 
to know to understand the information in the chapter. These tables clarify how 
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we use terms that may be used in several different ways in image processing 
literature. For example: 


se Sometimes in thefield ofimage processing,one word is used to describe more 
than one concept. For example the resolxvtzomn of an image can describe the 
height and width ofan image as a quantity of pixels in each direction, or 让 
can describe the number of pixels per linear measure, Such as 100 dots per 
inch. 


e Sometimes in the field ofimage processing, the same concepts are described 
by different terminology. For example, a srayscale image can also be called 
an 77 如 712s1ty image. 


NMATLAB Newsgroup 


Ifyou read newgsgroups on the Internet, you might be interested in the 
MATLAB newsgroup (comp .soft-sys.mat1lab). This newsgroup gives you 
accessgs to an active MATLAB user community. It is an excellent way to seek 
advice and to share algorithms, sample code, and M-files with other MATLAB 
Users. 


Typographical Conventions 





Typographical Conventions 


This manual uses some or all ofthese conventionsS. 





ltem 


Convenftion 


Example 





卫 xample code 


Function names,，Syntax，, 

和 lenames, qirectory/folder 
names, User input, items in 
drop-down lists 


Buttons and Keysg 


Literal strings (in syntax 
descriptiongs in reference 
chapters) 


Mathematical 
eXpresSlonsg 


MATLAB output 


Menu and dialog box titles 


New terms and for 
emphasis 


Omitted input arguments 


String variables (from a 
finite list) 


Monospace font 


Monospace font 


Boldqface with book title caps 


Monospace bold for literals 


Ttalics for variables 


Standard text font for fanctions， 
operators, and constants 


Monospace font 


Boldqface with book title caps 


Ttalics 


(...) ellipsis denotes all of the 
input/output arguments 位 om 
preceding Syntaxes. 


Monospace ItaJIcS 


To assign the value 5 to A，, 
enter 


A=5 


The cos function finds the 
cosine of each array element. 


Syntax line example is 
MLGetVar ML_var_name 


Press the Enter key 


f = freqspace(n，WwWhole ) 


This vector represents the 
polynomialp =x2 + 2x + 3. 


MATLAB responds with 
A = 
5 


Choose the File Options 
menu. 


An array is an ordered 
collection of information . 


[c,ia,ibl = union(...) 


SySC = d2c(SySsd，methooa ' ) 
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Image Processing Demos 


The Image Processing Toolbox is Supported by a full complement of demo 
applications. These are very useful as templates for your own end-userT 
applications, or for seeing how to use and combine your toolbox functions for 
powerful imnage analysis and enhancement. The toolbox demos are located 
under the subdirectory， 


matJlabroot\too1lbox\images\imdemos 


where matlabroot represents your MATLAB installation directory， 
The table below lists the demos available. 


The easiest way torun an individual demo is to enter its name atthe MATLAB 
command prompt. You can also launch MATLAB demos 位 om the MATLAB 
Demo Window. To evoke this window select Demos 他 om the Help menu ofthe 
main MATLAB window, or simply type demo at the command prompt. To see 
the list of available image processing demos, double-click on Toolboxes from 
the list on the left, then Select Image Processing. Select the desired demo and 
press the Run button. 


芒 you want to know whether there is a demo that uses a particular function， 
check the function name in the index. Ifthere is ademo that demonstrates this 
fonction, a subentry of “See also demoname”will appear, where demoname is the 
name of the demo. 





Demo Name Brief Descripftion 





dctdemo DCT image compression: you choose the number of 
coeffGicients and it shows you areconstructed image 
and an erTror image. 


edgedemo 了 dge detection: all supported types with optional 
manual control over thresholdq, qirection, and 
sigma, as appropriate to the method used. 


firdemo 2-D Finite Impulse Response (FIR) filters: design 
your own filter by changing the cut-o 任 frequency 
and flter order, 





Image Processing Demos 








imadjdemo 


Ipexconformal 


Ipexdeconvb1lind 


Ipexdeconv1Lucy 


1Ipexdeconvreg 


Ipexdeconvwnr 


IpexgranulLometry 


1IpexmriI 


1Ipexnormxcorr2 


1Ipexregaerial 


Contrast Adjustment and Histogram Equalization: 
adjust intensity values using brightness, contrast， 
and gamma correction, or by using histogram 
equalization . 


卫 xplore a Conformal Mapping: illustrates how to 
use spatial- and image-transformation functions to 
perform a conformal mapping. 


Deblurring Images Using the Blind Deconvolution 
Algorithm: illustrates use ofthe deconvb1lind 
fonction. 


Deblurring Images Using the Lucy-Richardson 
Algorithm: illustrates use ofthe deconvlLucy 
fonction. 


Deblurring Images Using a Regularized Filter: 
illustrates use ofthe deconvreg fanction. 


Deblurring Images Using the Wiener Filter: 
ilustrates use ofthe deconvwnr function. 


Finding the Granulometry of Stars in an Imasge: 
illustrates how to use morphology functions to 
perform granulometry, 


卫 xtracting Slices from a 3-Dimensional MRI Data 
Set: illustrates how to use the image 
transformation fanctions to interpolate and reslice 
a three-dimensional MRI data set, providing a 
convenient way to view a volume of data. 


Registering an Image Using Normalized 
Cross-correlation: illustrates how to use translation 
to align two images. 


Registering an Aerial Photo to an Orthophoto: 
illustrates how to use the Control Point Selection 
Tool to align two images. 
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1Ipexrotate 


Ipexsegcel1 


Ipexsegmicro 


Ipexsegwatershed 


1Ipexshear 


1Ipextform 


Ipss001 


Ipss002 


ipss003 


Finding the Rotation and Scale of a Distorted 
Image: illustrates hovw to use the cp2tform function 
to get the rotation angle and scale factor of a 
distorted image. 


Detecting a Cell Using Image Segmentation: 
illustrates hovw to use dilation and erosion to 
perform edge detection. 


Detecting Microstructures Using Imasge 
Segmentation: illustrates how to use morphological 
opening and closing to extract large objects fom an 
image. 


Detecting Touching Objects Using Watershed 
Segmentation: illustrates use of morphology 
fanctions to perform marker-control watershed 
segmentation. 


Padding and Shearing an Image Simultaneously: 
illustrates how to use the padding options ofthe 
image transformation functions. 


Creating a Gallery of Transformed Imasges: 
illustrates hovw to use the imtransform function to 
perform many types of image transformations. 


Connected Components Labelling: includes double 
thresholding, feature-based logic, and binary 
Imorphology All operations are performed on one 
Image. 


Feature-based Logic: Shows object selection using 
AND operations on the on” pixels in two binary 
images and shows filtering and thresholding on a 
single image. 


Correction of Nonuniform Ilumination: creates a 
coarse approximation of the background, subtracts 
世人 立 om the image, and then adjusts the pixel 
intensity values to f 有 1]] the entire range. 
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nrfiltdemo 


qtdemo 


Foidemo 


Noise Reduction Using Linear and Non-linear 
Filters: allows you to add different types of noise 
with variable densities, and choose a flter 
Deighborhood size. 


Quadtree Decomposition: select athreshold and see 
arepresentation ofthe sparse matrix and a 
reconstruction ofthe original image. 


Region of Interest (ROJT) Selection: select an ROI 
and apply operations such as unsharp and fi]11. Also 
displays the binary mask ofthe 有 ROL. 
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Getting Started 





This section contaings two examples to get you started doing image processing using MATLAB and the 
Image Processing Toolbox. The examples contain cross-references to other sections in this manual 
that have in-depth discussions on the concepts presented in the examples. 


卫 xample 1 一 Some Basic Topics Guides you through an example of some of the basic 
(p. 1-2) image processing capabilities of the toolbox, including 
reading, writing, and displaying images 


卫 xample 2 一 Advanced Topics (p. 1-9) Guides you through some more advanced image 
processing topics including components labeling, object 
property measurement, image arithmetic, morphological 
image processing, and contrast enhancement 


Where to Go from Here (p. 1-23) Provides pointers to additional sources of information 
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Example 1 一 Some Basic Topics 


Before beginning with this exercise, start MATLAB. Iyou are nevw to 
MATLAB, you should first read the MATLAB Getting Started documentation. 


You should already have installed the Image Processing Toolbox, which runs 
seamlessly from MATLAB. For information about installing the toolbox, see 
the MATLAB Installation Guide for your platform. 


All ofthe images used in this exzample are Supplied with the Image Processing 
Toolbox. Note thatthe images shown in this documentation differ slightly 位 om 
what you see on your Screen because the surrounding MATLAB figure window 
has been removed to save Space, 


1. Read and Display an Image 


Clear the MATLAB workspace ofany variables and close open figure windows. 


Clear，ClLose al1 


Toread an imnage,usethe imread command. Let's readin aTIFF imagenamed 
pout .tif (which is one ofthe sample images that is sSupplied with the Image 
Processing Toolbox), and store it in an array named I. 


I=imread(' pout.tif ) ; 


Now call imshow to display I. 


imshow(I) 
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HereS What Just Happened 





Step 1. The imread function recognized pout.tif as avalid TIFF fle and 
stored it in the variable I. (For the list of graphics formats Supported, see 
imread in the Image Processing Toolbox online “Function Reference.”) 


The fanctions imread and imshow read and display graphics images in 
MATLAB. In general, it is preferable to use imshow for displaying images 
because 过 handles the image-related MATLAB properties for you. (The 
MATLAB fanction image is for low-level programming tasks.) 


Note that 计 pout.tif were an 12Qexea image, the appropriate Syntax for 
imread would be， 


[X，map] = imread( :pout.tif ' ) ; 


(For more information on the supported image types, see“Image Types in 
the Toolbox”on page 2-5.) 











2. Check the Image in Memory 


Enter the whos command to see how I is stored in memory. 


Whos 


MATLAB responds with 


Name Size Bytes Class 
下 291X240 69840 uint8 array 


Grand total 1IS 69840 elements USing 69840 bytes 


1-3 
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1-4 





Heres What Just Happened 





Step 2. You called the whos command to see how pout .tif had been stored 
into the MATLAB workspace. As you Saw, pout .tif is stored as a 
291-by-240 array. Since pout .tif was an 8-bit image, it gets stored in 
memory as an Uint8 array. MATLAB can store images in memory as Uint8， 
uint16, or double arrays. (See “Reading a Graphics Image”on page 2-16 for 
an explanation of when the different storage classes are Used.) 











3. Perform Histogram Equalization 


As you can see, pout .tif is a somewhat low contrast image. To see the 
distribution of intensities in pout.tif in its current state, you camn create a 
histogram by calling the imhist fanction. (Precede the call to imhist with the 
figure command so that the histogram does not overwrite the display of the 
image I in the current fgure window.) 


figure，imhist(I) Display a histogram of I in a new figure. 
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Notice how the intensity range is rather narrow. It does not cover the potential 
range of [0, 255], and is missing the high and low values that would result in 
good contrast. 


Now call histed to spread the intensity values over the foll range, thereby 
improving the contrast of I. Return the modified image in the variable I2. 


I2 = histeq(I); 5 Equalize I and output in new array I2. 
Display the new equajlized image, I2, in a nevw figure window. 


figure，imshow(I2) 5 Display the new equalized image I2. 





Call imhist again, this time for I2. 


figure，imhist(I2) 5 Show the histogram for the new image I2.， 
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See how the pixel values now extend across the full range of possible values. 





Heres What Just Happened 





Step 3. You adjusted the contrast automatically by using the function 
histeq to evenly distribute the image's pixel values over the full potential 
range for the storage class ofthe image. For an image X, with a storage 
class of uint8, the fall rangeis 0<X<255,for uint16itis 0<X<65535 ， 
and for doubleitis 0<X<1.Note that the convention elsewhere in thigs 
user guide (and for all MATLAB documentation) is to denote the above 
ranges as [0,255], [0,65535], and [0,1j, respectively. 


Ifyou compare the two histograms, you can see that the histogram of I2 is 
more Spread out and flat than the histogram of I1. The process that 
fattened and spread out this histogram is called Aizstosramz egaLzza 砌 o7. 


For more control over adjusting the contrast of an image (for example, 计 
youwant to choose the range over which the new pixel values should span)， 
you can use the imadjust function, which is demonstrated under “5. Adjust 
the Image Contrast” on page 1-13 in Exercise 2. 
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4. Write the Image 


Write the newly adjusted image I2 back to disk. Let's say youd like to save 让 
as aPNGfile. Use imwrite and specify afilename that includes the extension 


"png . 
Imwrite (I2， pout2.png ) ; 





HereS What Just HapPpened 





Step 4. MATLAB recognized the file extension of 'png' as valid and wrote 
the image to disk. It wrote it as an 8-bit image by default because it was 
stored as a uint8 intengsity imnage in memory IfI2 had been an image arTay 
oftype RGB and class uint8, it would have been written to qisk as a 24-bit 
image. Iyou want to set the bit depth of your output image, use the 
BitDepth parameter with imwrite. This example writes a 4-bit PNG file. 


Imwrite(I2， ' pout2.png` ， "BitDepth ，4) 


Note that all output formats do not sSupport the same set of output bit 
depths. See imwrite in the Reference for the list ofvalid bit depths for each 
format. See also“Writing a Graphics Image”on page 2-17 for a tutorial 
discussion on writing images using the Image Processing Toolbox. 











5. Check fthe Contents of the Newly Written File 
Now, use the imfinfo function to see what was Written to disk. Be sure not to 
end the line with a semicolon so that MATLAB displays the results. Also, be 
Sure to use the same path (if any) as you did for the call to imwrite, above. 


imfinfo('pout2.png ') 
MATLAB responds with 
ans = 
Filename: pout2.png- 
FileModDate:'03-Jun-1999 15:50:25， 
FileSize:36938 


Format: ' png 
FormatVersion: [] 


1] ce ng Siorted 





Width:240 

Height:291 
BitDepth:8 
ColorType: 'graySscale， 





Notfte This example shows only a subset of all the fieldqs returned by imfinfo. 
Also, the value in the FileModDate field for your file will be different 位 om 
what is shown above. It will shovw the date and time that you used imwrite to 
create your Image. 








Heres What Just Happened 





Step 5. When you called imfinfo, MATLAB displayed all of the header 
fieldqs for the PNG file format that are Supported by the toolbox. You can 
modify many ofthese fieldqs by using additional parameters in your call to 
imwrite. The additional parameters that are available for each file format 
are listed in tables in the reference entry for imwrite. (See“Querying a 
Graphics File”on page 2-18 for more information about using imfinfo.) 
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Example 2 一 Advanced Topics 


In this exercise you will work with another intensity image, rice.tif, and 
explore some more advanced operations. The goals of this exercise are to 
remove the nonuniform background from rice.tif, convert the resulting 
image to a binary image by using thresholding, use components labeling to 
return the number of objects (grains or partial grains) in the image, and 
compute object statistics. 


1. Read and Display an Image 


Clear the MATLAB workspace of any variables and close open figure windows. 
Read and display the intensity image rice .tif. 


Clear，Cclose al1 
I= imnread(' rice.tif ' ) ; 
Imshow(I) 





2. Use Morphological Opening fo Estimate the 
Background 


Notice that the background illumination is brighter in the center of the image 
than at the bottom. Use the imopen function to estimate the background 
ilumination , 


background = imopen(I,Sstrel('disk' ,15) ) 
To see the estimated background image, type 


imshow(background ) 
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Heres What Just Happened 





Step 1. You used the toolbox functions imread and imshow to read and 
display an 8-bit intensity image. imread and imshow are discussed in 
卫 xercise 1, in “2. Check the Image in Memory”on page 1-3, under the 
“Heres What Just Happened”discussion. 


Step 2. You performed a morphological opening operation by calling 
imnopen with the input image, I, and a disk-shaped structuring element 
with aradius of 15. The structuring element was created by the strel 
function. The morphological opening has the effect ofremoving objects that 
cannot completely contain a disk ofradius 15. For more information about 
Imorphological opening, see Chapter 9，“Dilation- and Erosion-Based 
Functions.” 











3. Display the Background Approximaftion as a 
Surface 


Use the surf command to create a surface display of the background 
approximation, background. The surf function requires data of class doub1le， 
however, so you first need to convert background using the double command. 


figure，Ssurf(double(background(1:8:end;,1:8:end))),zlim([0 255]) ; 
Set(gca，ydir' ，reverse  ) ; 


The example uses MATLAB indexing syntax to view only 1 out of 8 pixels in 
each direction; otherwise the surface plot would be too dense. The example also 
sets the scale ofthe plot to better match the range ofthe uint8 data and 
reverses the y-axis ofthe qisplay to provide abetter view ofthe data (the pixels 
at the bottom ofthe image appear at the front ofthe surface plot). 
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HereSs What Just Happened 








Step 3. You used the surf command to examine the background imasge. 
The surf command creates colored parametric surfaces that enable you to 
View mathematical functions over a rectangular region. In the surface 
display [0, 0] represents the origin, or upper-left corner of the image. The 
highest part ofthe curve indicates that the highest pixel values of 
background (and consequently rice.tif)occurnear the middle rows ofthe 
image. The lowest pixel values occur at the bottom of the image and are 
represented in the surface plot by the lowest part of the curve. 


The surface plot is a Handle Graphics@ object, and you can therefore 
fine-tune its appearance by setting properties. For information on working 
with MATLAB graphics, see the MATLAB graphics documentation. 
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4. Subtiract the Background Image from the Original 
Image 

Novw subtract the background image, background, from the original image, I， 
to create a more uniform background. 


I2 = imsubtract(I,background ) ; 


Now display the image with its more uniform background. 


figure，imshow(I2) 








Heres What Just Happened 





Step 4. You subtracted a background approximation image 位 om rice.tif. 
Because subtraction, like many of MATLAB mathematical operations, is 
only Supported for data of class double, youmust use the Image Processing 
Toolbox image arithmetic imsubtract fanction. 


The Image Processing Toolbox has a demo, ipss003, that approximates and 
removes the background from an image. For information on how to run thig 
(and other demos), see“Image Processing Demos”in the Preface. 
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5. Adiust tfhe Image Contrast 


The image is now a bit too dark. Use imadjust to adqjust the contrast. 


I3 = imadjust(I2，Sstretchlim(I2)，[0 1]); 


Display the newly adjusted imasge. 


figure，imshow(I3) ; 








HereS5 What Just HapPpened 





Step 5. You used the imadjust command to increase the contrast in the 
image. The imadjust fanction takes an input image and can also take two 
vectors: [1ow high] and [bottom top]. The output image is created by 
mapping the value lowin the input image tothe value bottomin the output 
image, mapping the value high in the input image to the value top in the 
output image, and linearly scaling the values in between. See the reference 
pages for imadjust for more information. 


You called imadjust with stretchlim(I2) as the second argument. The 
stretchlim function automatically computes the right [low high] values 
to make imadjust increase (stretch) the contrast ofthe imasge. 
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6. Apply Thresholding to the Image 


Create anew binary thresholded image, bw, by usingthe functions graythresh 
and im2bw. 


Level = graythresh(I3) ; 
bw = im2bw(I3,1Level) ; 
figure，imshow(bw) 





Novw call the whos command to see whattype ofarray the thresholded image bw 
18， 


WwWhos 

MATLAB responds with 
Name Size Bytes Class 
I 256X256 65536 _ Uint8 array 
I2 256X256 65536 _ Uint8 array 
I3 256X256 65536 _ Uint8 array 
background 256Xx256 65536  Uint8 array 
bw 256X256 65536 1ogical array 
eve1] 1X1 8 double array 


Grand total 1Ss 327681 elementSs Using 327688 bytes 
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HereS5 What Just Happened 





Step 6. You called graythresh to automatically compute an appropriate 
threshold to use to convert the intensity image to binary. You then called 
im2bw to perform for thresholding, using the threshold, level, returned by 
graythresh. 


Notice that when you call the whos command, you see the expression 
1ogical listed after the class for bw. This indqicates the presence of a logical 
fag. Theflag indicates that bwis alogical matrix, and the Image Processing 
Toolbox treats logical matrices as binary images. Thresholding using 
MATLAB logical operators always results in a logical image. For more 
information about binary images and the logical flag, see “Binary Images?” 
on page 2-8. 











7. Determine fthe Number of Objects in the Image 


To determine the number of grains of rice in the image, use the bwlabe1 
fanction. This function labels all of the connected components in the binary 
image bw and returns the number ofobjects it fnds in the image in the output 
value, numobjects. 


[Labeled,numobjects] = bwlabel(bw,4) ;5 Label components ， 


numobjects = 


80 


The accuracy of your results depends on a number of factors, including: 


e The size ofthe objects 
e The accuracy of your approximated background 
e Whether you set the connectivity parameterto 4or 8 


e。 Whether or not any objects are touching (in which case they may be labeled 
as one object) In the example, some graings of rice are touching, so bwlabe1 
treats them as one object. 
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Heres What Just Happened 





Step 7. You called bwlabel to search for connected components and label 
them with unique numbers. bwlabel takes a binary input image and a 
value specifying the comz7mectzuzity of objects. The parameter 4, passed to the 
bwlabel function, means that pixels must touch along an edge to be 
considered connected. For more information about the connectivity of 
objects, see“Pixel Connectivity”in Chapter 9. 


You can also determine the number of objects in a label matrix by asking 
for the maximum pixel value in the image. For example， 


max(1abeled(:)) 


ansS = 





80 








8. Examine tfhe Label Maftrix 


Youmay find 过 helpfultotakeacloserlook at labeledto see whatbwlabelhas 
created. Use the imcrop command to select and display pixels in a region of 
labeled that includes an object and some background. 


To ensure thatthe output is displayed in the MATLAB window, do not end the 
line with a semicolon. In addition, choose a small rectangle for this exercise, So 
that the displayed pixel values dont wrap in the MATLAB command window. 


The syntax shown below makes imcrop work interactively. Your mouse cursoT 
becomes a cross-hair when placed overthe image. Click ata position in labeled 
where you would like to select the upper left corner of aregion. Drag the mouse 
to create the selection rectangle, and release the button when you are done. 


gralin = imcrop(Llabeled) 5 Crop a portion of labeled . 
We chose the left edge of a grain and got the following results. 


grain = 
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DOoOoOoOoODODODODODOD 
和 
5 


0 0 60 60 60 60 
0 0 0 0 0 0 
0 0 0 0 0 0 


Agood way to view alabel matrix is to display it as a pseudo-color indexed 
image. In the pseudo-color image, thenumberthat identifies each object in the 
label matrix maps to a different color in the associated colormap matrix. When 
you View a label matrix as an RGB image, the objects in the image are easier 
to distingujish. 


To view a label matrix in this way, use the Labe1l2rgb function. Using this 
function, you can specify the colormap, the background color, and how objects 
in the label matrix map to colors in the colormap. 


RGB_label = JabeJ2rgb(Jabeled，Qspring， ' c'`， Shuffle ) ; 
Imshow(RGB_ Label) ; 
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Heres What Just Happened 





Step 8. You called imcrop and selected a portion of the image that 
contained both some background and part of an object. The pixel 
values were returned in the MATLAB window. Ifyou examine the 
results above, you can see the corner of an object labeled with 60?”s， 
which means that it was the 60th object labeled by bwlabe1. 


The imcrop function can also take a vector specifying the 
coordinates for the crop rectangle. In this case, it does not operate 
interactively. For example, this call specifies a crop rectangle whose 
Upper-left corner begins at (15, 25) and has a height and width of 10. 


rect = [15 25 10 10] | 
roil = imcrop(lLabeled，rect) 


You are not restricted to rectangular regions of interest. The toolbox 
also has a roipoly command that enables you to select polygonal 
regiongs of interest. Many image processing operationgs can be 
performed on regions of interest, including filtering and filling. See 
Chapter 11，“Region-Based Processing” for more information. 


The call to label2rgb illustrates a good way to visualize label 
matrices. The pixel values in the label matrix are used as indices 
into a colormap. Using Labe12rgb, you can Specify your own 
colormap or use one of the MATLAB colormap-creating functions， 
including gray, pink, spring, and hsv. For information on these 
fuanctions, see colormap in the MATLAB Fuwmc 万 om 民 efere7zce. 








9. Measure Object Properties in the Image 


The regionprops command measures object or region properties in an image 
and returns them in a structure arTay. When applied to an image with labeled 


components, it creates one Structure element for each component. Use 


regionprops to create a Structure array containing Some basic properties for 


1abeled. 
graindata = regionprops(1Llabeled，basic ' ) 


MATLAB responds with 
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graindata = 


80x1 struct array With fields: 
Area 
Centroid 
BoundingBox 


To find the area of the component labeled with 51's, use dot notation to accesSs 
the Area fieldq in the 51lst element in the graindata structure array. Note that 
structure field names are case sengsitive, so youneed to capitalize the name as 
Shown， 


graindata(51) .Area 
returns the following results 
ans = 
296 


Tofindthe smallest possible bounding box and the centroid (center ofmass) for 
the same component, use this code: 


graindata(51).BoundingBox，graindata(51).Centroid 


ans = 


142.5000 “89.5000 24.0000 26.0000 
ans = 


155.3953 102.1791 


To create anew vector, allgrains, which holdqs just the area measurement for 
each grain, use this code: 


allgrains = [graindata.Areal]; 
whos allgrains 


Call the whos command to see how MATLAB allocated the allgrains variable. 


Name Size Bytes Class 


allgrains 1x80 640 double array 
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Grand total 1S 80 elements using 640 bytes 


allgrains is a one-Trow array of 80 elements, where each element contains the 
area measurement of a grain. Check the area ofthe51lst element ofall1grains. 


allgrains(51) 
returmns 
ans = 
296 


which is the same result that you received when using dot notation to access 
the Area field of graindata(51). 





Heres What Just Happened 





Step 9. You called regionprops to return a Structure of basic property 
measurements for each thresholded grain ofrice. The regionprops function 
Supports many different property measurements, but setting the 
properties parameter to 'basic'is a convenient way to return three ofthe 
most commonly used measurements: the area, the centroid (or center of 
mass), and the bounding box. The bounding box represents the smallest 
rectangle that can contain a region, or in this case, a grain. The 
four-element vector returned by the BoundingBox field， 


[142.5000 “89.5000 24.0000 26.00001] 


showsthatthe upper left corner ofthe bounding boxis positioned at [142.5 
89.5], and the box has a width of 24.0 and a height of 26.0. (The position 
is defined in spatial coordinates, hence the decimal values. For more 
information on the spatial coordinate system, see“Spatial Coordinates”on 
page 2-29.) For more information about working with MATLAB structure 
arTays, see“Structures”in the MATLAB programming and data typesgs 
documentation. 


You used dot notation to access the Area field of all ofthe elements of 
graindata and stored this data to a new vector allgrains. This step 
simplifies analysis made on area measurements because you do not have to 
use field names to access the area. 
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10. Compute Statistical Properties of Objects in fthe 
Image 


Now use MATLAB functions to calculate some statistical properties ofthe 
thresholded objects. First use max to find the size of the largest grain. (If you 
have followed all ofthe steps in this exercise, the“largest grain” is actually two 
graings that are touching and have been labeled as one object). 


max(allgrains ) 
returns 
ans = 
695 
Use the find command to return the component label of this large-sized grain, 
biggrain = find(allgrains==695) 
returns 
biggrain = 
68 


Find the mean grain Size. 


mean(allgrains) 
returns 
ans = 
249 


Make a histogram containing 20 bins that shovw the distribution of rice grain 
S1ZeS， 


hist(allgrains ,20) 
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Heres What Just Happened 








Step 10. You used some ofthe MATLAB statistical fanctions, max, mean, and 
hist to return the statistical properties for the thresholded objects in 
rice .tif. 


The Image Processing Toolbox also has some statistical faunctions, Such as 
mean2 and std2, which are well suited to image data because they return a 
single value for two-dimensional data. The fanctions mean and std were 
Suitable here because the data in allgrains was one dimensional. 


The histogram shows that the most common Sizes for rice graings in this 
image are in the range of 300 to 400 pixels. 








Where to Go from Here 





Where to Go from Here 


For more information about the topics covered in these exercises, read the 
tutorial chapters that make up the remainder ofthis documentation. For 
reference information about any ofthe Image Processing Toolbox functions, see 
the online“Function Reference”, which complements the M-file help that is 
displayed in the MATLAB command window when you type 


help functionname 


For example， 


help imshow 


Online Help 


The 77zase Processi1s Toolbox Users Guiae is available online in both HTMEL 
and PDF formats. To access the HTML help, select Help 他 om the menu bar of 
the MATLAB desktop. In the Help browser, exzpand the Image Processing 
Toolbox topic in the list. To access the PDF help, click on Image Processing 
Toolbox in the Contents tab ofthe Help browser, and go to the link under 
“Printable Documentation (PDF).” (Note that to view the PDF help, you must 
have Adobe's Acrobat Reader installed.) 


Toolbox Demos 


The Image Processing Toolbox includes many demo applications. The demos 
are useful for seeing thetoolbox features put into action and for borrowing code 
for your own applications. See“Image Processing Demos”in the Preface for a 
complete list and summary ofthe demos, as well as instructions on how to run 
them. 
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Introductlion 








This section introduces you to the fondamentals of image processing using MATLAB and the Image 
Processing Toolbox. Topics covered include 


Terminology (p. 2-2) 

Images in MATLAB and the Image 
Processing Toolbox (p. 2-4) 

Image Types in the Toolbox (p. 2-5) 
Working with Image Data (p. 2-15) 


Image Arithmetic (p. 2-21) 


Coordinate Systems (p. 2-28) 


Provides definitions of image processing terms used in 
this section 


Describes how images are represented in MATLAB and 
the Image Processing Toolbox 


Describes the fundamental image types Supported by the 
Image Processing Toolbox 


Describes hovw to read, write, and perform other common 
image tasks 


Describes hovw to add, subtract, multiply and divide 
Imagesg 


卫 xplaings image coordinate Systems 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


Definitions 





Binary image 


Image fypPe 


Indexed image 


Intensity image 


Mulfiframe image 


An image containing only black and white pixels. In MATLAB， 
a binary image is represented as a logical array of 0's and 1S 
(which usually represent black and white, respectively). This 
documentation often uses the variable name BW to represent a 
binary image in memory. 


The defined relationship between array values and pixel 
colors. The toolbox Supports binary indexed, intensity and 
RGB image types. 


An image whose pixel values are direct indices into an RGB 
colormap. In MATLAB, an indexed image is represented by an 
array of class uint8, uint16, or doub1le. The colormap is 
always an m-by-3 array of class doub1e. We often use the 
variable name X to represent an indexed image in memory， 
and map to represent the colormap. 


An image consisting of intensity (grayscale) values. In 
MATLAB, intengsity images are represented by an arTay of 
class Uint8, uint16, or doub1e. While intensity images are not 
stored with colormaps, MATLAB uses a System colormap to 
display them. We often use the variable name I to represent 
an intengsity imnage in memory This term is Synonymous with 
the term Srayscale.， 


An image file that contains more than one image, or 广 a77ze. 
When in MATLAB memory a multiframe image is a 4-D array 
where the fourth dimension specifies the 位 ame number This 
term is Synonymous with the term 7VL 万 pagse image. 
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Terms 


Definitions 





RGB image 


Storage class 


An image in which each pixel is specified by three values 一 one 
each for the red, green, and blue components of the pixels 
color. In MATLAB, an RGB image is represented by an 
Im-by-n-by-3 array of class uint8, uint16, or doub1e. We often 
use the variable name RGB to represent an RGB image in 
memory. 


The numeric storage class used to store an image in MATLAB. 
The storage classes used in MATLAB are uint8, uint16, and 
double. Some function descriptions in the reference chapter of 
this Users Guide have a section entitled “Class Support” that 
specifies which image classes the function can operate on. 
When this section is absent, the function can operate on all 
SUpported storage classes. 
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Images in MATLAB and the Image Processing Toolbox 


The basic data structure in MATLAB is the array, an ordered set of real or 
complex elements. This object is naturally suited to the representation of 
17zasSes, real-valued ordered sets of color or intensity data. 


MATLAB stores most images as two-dimensional arrays (ie., matrices), in 
which each element ofthe matrix corresponds to asingle pixel in the displayed 
image. (Pixel is derived 位 om pictzre elemezt and usually denotes a single dot 
on a computer display.) For example, an image composed of 200 rowsg and 300 
columns of different colored dots would be stored in MATLAB as a 200-by-300 
matrix. Some images, such as RGB, require a three-dimensional array, where 
the first plane in the third dimension represents the red pixel intengsities, the 
second plane represents the green pixel intengsities, and the third plane 
represents the blue pixel intengsities. 


This convention makes working with images in MATLAB similar to working 
with any other type ofmatrix data, and makes the full power of MATLAB 
available for image processing applications. For example, you can select a 
single pixel from an image matrix using normal matrix Subscripting. 


I(2,15) 


This command returns the value ofthe pixel atrow 2, column 15 ofthe image I. 


Storage Classes in the Toolbox 


By default, MATLAB stores most data in arrays of class double. The data in 
these arraysgs is stored as double precision (64-bit) floating-point numbers. Al 
MATLAB functions work with these arraysS. 


For image processing, however, this data representation is not always ideal. 
The number of pixels in an image may be very large; for example, a 
1000-by-1000 image has a million pixels. Since each pixel is represented by at 
least one array element, this image would require about 8 megabytes of 
memory. 


To reduce memory requirements, MATLAB supports storing image data in 
arrays as 8-bit or 16-bit unsigned integers, class uint8 and uint16. These 
arTays requjire one eighth or one fourth as much memory as double arrays. 
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Image Types in the Toolbox 


The Image Processing Toolbox Supports four basic types of images: 


e Indqex images 

e Intenslity images 
e Binary images 

e RGB images 


This section discusses how MATLAB and the Image Processing Toolbox 
represent each of these image types, 


Indexed Images 


An indexed image consists ofa data matrix, X, and a colormap matrix, map. The 
data matrix can be of class uint8, uint16, or doub1le. The colormap matrix is 
an m-by-3 array of class double containing floating-point values in the range 
[0,1 .Each row ofmap specifies the red, green, and blue components of a single 
color.An indexed image uses direct mapping ofpixel values to colormap values. 
The color of each image pixel is determined by using the corresponding value 
of Xx as an index into map. The value 1 points to the firstrow in map, the value2 
points to the second row, and so on . 


A colormap is often stored with an indexed image and is automatically loaded 
with the imnage when youusethe imread function. However,youarenot limited 
to using the default colormap 一 you can use any colormap that you choose. The 
和 figure below illustrates the structure of an indexed image. The pixels in the 
image are represented by integers, which are pointers (indqices) to color values 
stored in the colormap. 
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14 17 21 21 53 5 





Figure 2-1: Pixel Values Are Indices to a Colormap in Indexed Images 


Class and Colormap Offsets 


The relationship between the values in the image matrix and the colormap 
depends on the class ofthe image matrix. Ifthe imagematrix is ofclass doub1le， 
the value 1 points to the first row in the colormap, the value 2 points to the 
second row, and so on. Ifthe image matrix is ofclass uint8 or uint16, there is 
an offset 一 the value 0 points to the first row in the colormap,the value 1 points 
to the second row, and So on. 


The offset is also used in graphics file formats to maximize thenumber ofcolors 
that can be supported. In the image above,the image matrix is ofclass doub1e. 
Because there is no offset, the value 5 points to the fifth row ofthe colormap， 


Limitaftions fo uint16 Supporf 

Note that the toolbox provides limited support for indexed images of class 
uUint16. You can read these images into MATLAB and display them, but before 
you can process a uint16 indexed image you must first convert it to either a 
double or a uint8. To convert to a double, call im2doublei; to reduce the image 
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to 256 colors or fewer (uint8) call imapprox. For more information, see the 
reference pages for im2double and imapprox. 


Intensity Images 


An intensity image is a data matrix, TI, whose values represent intensitiegs 
within some range.MATLAB stores an intensity image as a single matrix, with 
each element of the matrix corresponding to one image pixel. The matrix can 
be of class double, uint8, or uint16.While intensity images are rarely saved 
with a colormap, MATLAB uses a colormap to display them. 


The elements in the intensity matrix represent various intensities, or gray 
levels, where the intensity 0 usually represents black and the intensity 1, 255， 
or 65535 usually represents full intensity, or white. 


The figure below depicts an intensity image of class doub1e. 





-2251 0.2563 0.2826 0.2826 0 

0.5342 0.2051 0.2157 0.2826 0.3822 0.4391 0.439 
0.5342 0.1789 0.1307 0.1789 0.2051 0.3256 0.2483 
Q.4308 0.2483 0.2624 0.3344 0.3344 0.2624 0.2549 
0.2624 0.3344 0.3344 0. 












Figure 2-2: Pixel Values in an Intensify Image Define Gray Levels 
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Binary Images 


In a binary image, each pixel assumes one of only two discrete values. 
了 ssentially, these two values correspond to on and off. A binary image is 
stored as a 1ogical array of 0's (off pixels) and 1s (on pixels). 


The figure below depicts a binary image. 


coeoecenmeo 
Pbpbeooeoem-oececececeoc 
口 一 Doeoeoeob 
人 





Figure 2-3: Pixels in a Binary Image Have Two Possible Values:0Oor 1 


RGB Images 


An RGB image, sometimes referred to as a 杂 Vecolor image, is stored in 
MATLAB as an m-by-n-by-3 data array that defines red, green, and blue color 
components for each individual pixel. RGB images do not use a palette. The 
color of each pixel is determined by the combination ofthe red, green, and blue 
intengsities stored in each color plane at the pixel's location. Graphics file 
formats store RGB imasges as 24-bit images, where the red, green, and blue 
components are 8 bits each. This yieldqs a potential of 16 million colors. The 
precision with which a real-life image can be replicated has led to the 
commonly used term truecolor imasge. 


An RGB MATLAB array can be of class double, uint8, or uint16. In an RGB 
array of class double, each color component is avalue between 0 and 1. A pixel 
whose color components are (0,0,0) displays as black, and a pixel whose color 
components are (1,1,1) displays as white. The three color components for each 
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pixel are stored along the third dimension of the data array. For example, the 
red, green, and blue color components of the pixel (10,5) are stored in 
RGB(10,5,1), RGB(10,5,2), and RGB(10,5,3), respectively. 


Figure 2-4 depicts an RGB image of class doub1e. 










Blue 9 
0.2902 0.2902 






co2235 0.1294 
.2902 0.0627 








0.48> 







0.1922 0.2588 
0.1294 0.1294 0.2588 0.2588 |5 
0.1922 
0.7412 
0 0.5176 0.5804 0.5804 0.7765 0.7765 
0.2588 0.2902 0.2588 0.2235 0.4824 
0 0 

0 









.1608 0.2588 0.2588 0.1608 
0.2588 






Figure 2-4: The Color Planes of an RGB Image 


To determine the color of the pixel at (2,3), you would look at the RGB triplet 
stored in (2,3,1:3). Suppose (2,3,1) contains the value 0.5176, (2,3,2) containsg 
0.1608, and (2,3,3) contains 0.0627. The color for the pixel at (2,3) is 


0.5176 0.1608 0.0627 


To further illustrate the concept ofthe three separate color planes used in an 
RGB image, the code sample below creates a simple RGB image containing 
uninterrupted areas of red, green, and blue, and then creates one image for 
each of its separate color planes (red, green, and blue). It displays each color 
plane image separately, and also displays the original image. 
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RGB=reshape 
R=RGB(:，:，1 
G=RGB( :，: ,2 
B=RGB(:，,: ,3 
imshow(R) 
figure，imshow(G) 
figure，imshow(B) 
figure，imshow(RGB ) 


( 

) ; 
) ; 
) ; 


了 


Red Plane 





Blue Plane 


Figure 2-5: The Separated Color Planes of an RGB Image 


ones(64,1)*reshape(jet(64) ,1,192),[64,64,3]) 


Green Plane 


Original Image 
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Notice that each separated color plane in the figure contains an area of white. 
The white corresponds to the highest values (purest shades) of each separate 
color. For example, in the Red Plane image, the white represents the highest 
concentration of pure red values. As red becomes mixed with green or blue， 
gray pixels appear. The black region in the image shows pixel values that 
contain no red values, ji.e., R == 0. 


Mulfiframe Image Arrays 


For some applications, you may need to work with collections of images related 
by time or view, Such as magnetic resonance imaging (MRIJ) slices or movie 
位 ames. 


The Image Processing Toolbox provides Support for storing multiple images in 
the same array. 卫 ach separate image is called a jame. Ian array holds 
multiple 位 ames, they are concatenated along the fourth dimension. For 
example, an array with five 400-by-300 RGB images would be 
400-by-300-by-3-by-5.A similar multiframe intensity or indexed image would 
be 400-by-300-by-1-by-5. 


Use the cat command to store separate images into one multiframe file. For 
example,ifyouhaveagroup ofimages A1,A2,A3,A4, and A5, youcan store them 
in a single array using 

A = cat(4,A1,A2,A3,A4,A5) 


You can also extract fames from amultiframe image. For example, ifyou have 
amultiframe image MULTI, this command extracts the third 位 ame. 


FRM3 = MULTI(:，,:，:),3) 


Note that in amultiframe image array, each image must be the same size and 
have the same number of planes. In a multiframe indexed image, each image 
must also use the same colormap. 


Mulfiframe Supporft Limitations 

Many ofthe functions in the toolbox operate only on the first two or first three 
dmensions.You can still use four-dimensional arrays with these functions, but 
you must process each frame individually. For example, this call displays the 
seventh ffame in the array MULTI. 


imshow(MULTI(:，:，,，:，7)) 
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Iyoupass an arTay to a function and the array has more dimensiongs than the 
fonction is designed to operate on, your results may be unpredictable. In some 
cases, the function simply processes the first 位 ame ofthe array, but in other 
cases the operation does not produce meaningful results. 


See the reference pages for information about how individual fanctions work 
with the dimensions of an image array. For more information about displaying 
multiframe images, see Chapter 3 “Displaying and Printing Images.” 


Summary of Image Types and Numeric Classes 


This table summarizes the way MATLAB interprets data matrix elements as 
pixel colors, depending on the image type and storage class. 








Image Storage Class Inferpretaftion 
Type 
Binary 1ogical An array of zeros (0) and ones (1) 


Indqexed1i doub1le 
Uint8 or Uint16 


Intensityl double 
Uint8 or Uint16 
RGB double 


(Truecolor) 


Uint8 or Uint16 


An array of integers in the range [1，PD] 
An array of integers in the range [0, p-H] 


An array of floating-point values. The 
typical range of values is [0, 革 . 


An array of integers. The typical range 
ofvalues is [0, 255] or [0, 65535]. 


An m-by-n-by-3 array of floating-point 
values in the range [0, 二 . 


An m-by-n-by-3 array of integers in the 
range [0, 255] or [0, 65535]. 





1. The associated colormap is a p-by-3 array of floating-point values in the 
range [0, 1]. For intensity images the colormap is typically grayscale. 


Converting Image Types 


For certain operations, it is helpful to convert an image to a different image 
type. For example, 让 you want to filter a color image that is stored as an 
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indexed image, you should first convert it to RGB format. When you apply the 
filter to theRGB image, MATLAB filters the intensity values in the image, as 
is appropriate. If you attempt to filter the indexed image, MATLAB simply 
applies the filter to the indices in the indexed image matrix, and the results 
may not be meaningful]. 





Nofte When you convert an image 位 om one format to another the resulting 
image may look different 位 om the original. For example, 计 you convert a color 
indexed image to an intengsity image, the resulting image is grayscale, not 
color. For more information about how the image conversion functions listed 
below, see their reference pages. 





The following table lists all the image conversion functions in the Image 
Processing Toolbox. 








Function Descripiion 

dither Create abinary image 位 om a grayscale intensity image 
by dithering; create an indexed image fom an RGB 
image by dithering 

gray2ind Create an indexed image 位 om a grayscale intensity 
Image 

grayS1lice Create an indexed image from a grayscale intensity 
image by thresholding 

Im2bw Create a binary image 位 om an intensity image， 
indexed image, or RGB image, based on a luminance 
threshold 

ind2gray Create a grayscale intensity image from an indexed 
image 

ind2rgb Create an RGB image from an indexed image 

mat2gray Create a grayscale intengsity image 位 om data in a 


matrix, by scaling the data 


2-13 


2 Introduction 








Function Descripfion 
rgb2gray Create a grayscale intensity image from an RGB image 
rgb2ind Create an indexed image from an RGB image 





You can also perform certain conversions just using MATLAB syntax. For 
example, you can convert an intengsity image to RGB format by concatenating 
three copies ofthe original matrix along the third dimension . 


RGB = cat(3,I,I, 工 ) ; 


The resulting RGB image has identical matrices for the red, green, and blue 
planes, so the image displays as shades of gray. 


In adqddition to these standard conversion tools, there are some functions that 
return a different image type as part of the operation they perform. For 
example, the region-of-interest routines each return a binary image that you 
can use to mask an indexed or intengsity image for filtering or for other 
operations， 


Color Space Conversions 


The Image Processing Toolbox represents colors as RGB values, either direct]y 
(Gin an RGB image) or indirectly (in an indexed image). However, there are 
other methods for representing colors. For example, a color can be represented 
by its hue, saturation, and value components (HSV). Different methods for 
representing colors are called color spaces. 


The toolbox provides a set of routines for converting between RGB and other 
color spaces. The image processing functiongs themselves assume all color data 
is RGB, but you can process an image that uses a different color space by first 
converting it to RGB, and then converting the processed image back to the 
original color space. For more information about color space conversion 
routines, see Chapter 13“Color.” 
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Working with Image Data 


Images are most commonly stored in MATLAB using the logical, uint8， 
uint16 and double data types. This section describes how to work with image 
data in MATLAB. Topics include: 

e Reading images into the MATLAB workspace 

e。 Writing images to files, in many standard graphics file formats 

e Querying graphics image files for information stored in header fieldqs 

e Converting images between image storage classes 

e Converting images between graphics file formats 

For information about displaying and printing images, see “Displaying and 
Printing Images”. 

You can also perform many standard MATLAB array manipulations on Uint8 
and uint16 image data, including: 

e。 JIndexing, includqing logical indexing 

e Reshaping, reordering, and concatenating 

e Reading from and writing to MAT-files， 

e。 Using relational operators 

Certain MATLAB functions, including the find,all,any,， conv2，convn，fft2， 


fftn, and sum functions accept uint8 or uint16 data but return data in double 
precision format. 


The basic MATLAB arithmetic operators, however, do not accept uint8 or 
uint16 data. For exzample,ifyou attemptto add two uint8 images,A and B, you 
get an error, Such as， 


C=A+B 
?3?3? Function '+' not defined for variables of class 'Uint8 ' . 


Because these arithmetic operations are an important part of many 
image-processing operations, the Image Processing Toolbox includes functions 
that Support these operations on uint8 and uint16 data, as well as the other 
numeric data types. See“Imasge Arithmetic”for more information. 
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Reading a Graphics Image 


The function imread reads an image from any Supported graphics image file 
format, in any ofthe supported bit depths. Most image file formats use 8 bits 
to store pixel values. When these are read into memory, MATLAB stores them 
as class uint8. For file formats that Support 16-bit data, PNG and TIFF， 
MATLAB stores the images as class uint16. As with MATLAB-generated 
images, once a image is displayed, it becomes a Handle Graphics Image object. 





Notfte For indexed images, imread always reads the colormap into an array of 
class double, even though the image array itselfmay be of class uint8 or 
Uint16. 





For example, this code reads the image ngc6543a. jpg into the MATLAB 
workspace as the variable RGB. 


RGB = imread('ngc6543a.jpg ') 


In this example, imread infers the file format to use 他 om the contents of the 
file. You can also specify the file format as an argument to imread. MATLAB 
Supports the following graphics le formats: 

e BMP (Microsoft Windows Bitmap) 

e CUR (Microsoft Windows Cursor resource) 

e GIF (Graphics Interchange Format) 

e HDF (Hierarchical Data Format) 

e ICO (Windows Icon resource 

e。 JPEG (Joint Photographic 玉 xperts Group) 

ePBM (Portable Bitmap) 

e。 PCX (Windows Paintbrushy) 

e。 了 PGM (Portable Graymap) 

e PNG (Portable Network Graphics) 

se PPM (Portable Pixzmap) 

eRAS (Sun Raster image) 

e TIFF (Tagged Image File Format) 

eXWD (X Window Dump) 
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For the latest information concerning the bit depths and/or image formats 
SUpported, see the reference pages for imread. 


Writing a Graphics Image 

The function imwrite writes an imageto agraphics file in one ofthe supported 
formats. The mostbasic syntax for imwrite takes the imagevariable name and 
afilename. Ifyou include an extension in the filename, MATLAB infers the 
desired file format fom it. This example loads an image of a clown from a 
MAT-file, and then creates a BMP file containing the clown image. 


1oad clown 

Whos 
Name Size Bytes Cl1Lass 
X 200x320 512000 double array 
caption 2x1 4 char array 
map 81Xx3 1944 double array 


Grand total Is 64245 elements Using 513948 bytes 


Imwrite(X,map， clown.bmp ) 


For some graphics formats, you can specify additional parameters. One of the 
additional parameters for PNG files sets the bit depth. This example writes an 
intensity image Ito a 4-bit PNG file. 


Imwrite(I， clown.png ，BitDepth ,4) ; 


The bit depths and image types Supported for each format are shown in the 
reference pages for imwrite， 


This example writes an image Ato aJPEG file with a compression quality 
setting of 100 (the default is 75). 


Imwrite(A，'myfile.jpg ， Quality ，100) 
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Output File Storage Classes 


imwrite uses the following rules to determine the storage class used in the 
output image. 








Storage Class Storage Class of Output Image File 
of Image 
1ogical Ifthe output image file format specified supports 


1-bit images, imwrite creates a 1-bit image file. 


Ithe output image fle format specified coes mot 
Support 1-bit images, such as JPEG,， imwrite 
converts the imasge to a class uint8 intensity image. 


Uint8 Ithe output image file format specified supports 
8-bit images, imwrite creates an 8-bit image file. 


Uint16 Ifthe output image file format specified supports 
16-bit imnages (PNG or TIFF), imwrite creates a 
16-bit image 提 ile. 


Ithe output image fle format specified coes mot 
SUupport 16-bit images, imwrite Scales the image 
data to class uint8 and creates an 8-bit image fle. 


double MATLAB scales the image data to uint8 and creates 
an 8-bit image fle because most image file formats 
Use 8-bits. 





See the reference entry for imwrite for more information. 


Querying a Graphics File 

The imfinfo function enables you to obtain information about graphics files 
that are in any ofthe formats Supported by the toolbox. The information you 
obtain depends on the type of file, but it always includes at least the following: 
eName ofthe file 

e File format 


e Version number of the file format 
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e File modification date 

e File Size in bytesg 

e。 JImage width in pixels 

e。 JImage height in pixels 

se Number of bits per pixel 

e。 Image type: RGB (truecolor), intensity (grayscale), or indexed 


See the reference entry for imfinfo for more information. 


Converting Image Storage Classes 


You can convert uint8 and uint16 data to double precision using the MATLAB 
function, doub1le. However, converting between Storage classes changes the 
way MATLAB and the toolbox interpret the image data. Iyou want the 
resulting array to be interpreted properly as image data, youneed to rescale or 
offset the data when you convert t. 


For easier conversion of storage classes, use one of these toolbox functions: 
im2double, im2uint8, and im2uint16. These functions automatically handle 
the rescaling and offsetting ofthe original data. For example, this command 
converts a double-precision RGB imasge with data in the range [0,1] to a uint8 
RGB image with data in the range [0,255|]. 


RGB2 = im2uint8(RGB1) ; 


Losing Information in Conversions 

When you convert to a clasgs that uses fewer bits to represent numbers, yoU 
generally lose some of the information in your image. For example, a uint16 
intensity image is capable of storing up to 65,536 distinct shades of gray, but a 
uint8 intengsity image can store only 256 distinct shades of gray. When you 
convert a Uint16 intenslity Image to a uint8 intenslity Image, im2uint8 
QUa7tizes the gray shades in the original image. In other words, all values from 
0to 127 in the original image become 0in the uint8 image, values 他 om 128 to 
385 all become 1l, and so on. This loss of information is often not a problem， 
however, since 256 still exceeds the number of shades of gray that your eye is 
likely to discern , 
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Converting Indexed Images 


Lt is not always possible to convert an indexed image 人 from one Storage class to 
another. In an indexed image, the image matrix contains only indices into a 
colormap, rather than the color data itself, so no quantization ofthe color data 
is possible during the conversion. 


For example, a uint16 or double indexed image with 300 colors cannot be 
converted to uint8, because uint8 arrays have only 256 distinct values. Ifyou 
wantto perform this conversion,youmust firstreduce the number ofthe colors 
in the image using the imapprox fanction. This function performs the 
quantization on the colors in the colormap, to reduce the number of qistinct 
colors in the image. See“Reducing Colors in an Indexed Image”on page 13-12 
for more information. 


Converting Graphics File Formats 


To change the graphics format of an image,use imread toread in the image and 
then save the image with imwrite, specifying the appropriate format. 


For example, to convert an image from a BMP to aPNG, read the BMP image 
using imread, convert the storage clasgs ifnecessary, and then write the image 
using imwrite, with 'PNG' specified as your target format. 


bitmap = imread( mybitmap.bmp ，bmp ); 
Imwrite(bitmap，mybitmap.png ，png ) 
For the specifics of which bit depths are Supported for the different graphics 


formats, and for hovw to specify the format type when writing an image to file， 
See the reference entriegs for imread and imwrite. 


Image Arithmetic 





Image Arithmefic 


Image arithmetic is the imnplementation of standard arithmetic operations， 
such as addition, subtraction, multiplication, and division, on images. Image 
arithmetic has many uses in image processing both as a preliminary step in 
Imore complex operations and by itself. For example, image subtraction can be 
used to detect differences between two or more images of the same Scene or 
object. 


You can do image arithmetic using the MATLAB arithmetic operators; 
however, you must convert the images to class double to use these operators, 
To make working with images more convenient, the Image Processing Toolbox 
includes a set of functions that implement arithmetic operations for all 
numeric, nonsparse data types. The advantages to using these functiongs 
include: 


e No conversion to the double data type is necessary. The functions accept any 
numeric data type, including uint8, uint16, and double, and return the 
result image in the same format. Note that the functions perform the 
operations in double precision, on an element-by-element basis, but do not 
convert images to double precision values in the MATLAB workspace. 


e Overflow is handled automatically. The functiongs truncate return values to 


fit the data type. For details about this truncation, see“Image Arithmetic 
Truncation Rules”on page 2-22. 


See “Summary ofImage Arithmetic Functions”on page 2-22 for acomplete list. 
For more information about using these functions to perform arithmetic 
operations, see these sections: 


es“Adding Images”on page 2-23 


“Subtracting Images”on page 2-24 


“Multiplying Images”on page 2-25 


“Dividing Images”on page 2-27 


“Nesting Calls to Image Arithmetic Functions”on page 2-27 
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Summary of Image Arithmeftic Funcfions 


The following table lists the image arithmetic functions. For more complete 
descriptions, see their reference pages. 








Function Descripfion 

imabsdiff Absolute difference of two images 

imadd Add two images 

imcompLement Complement an image 

imdivide Divide two images 

imlincomb Compute linear combination of two images 
immu1ltip1ly Multiply two images 

imsubtract Subtract two images 





Image Arithmetic Truncation Rules 


The results of integer arithmetic can easily overflow the data type allotted for 
storage. For example, the maximum value you can store in uint8 data is 255. 
Arithmetic operations can also result in fractional values, which cannot be 
represented using integer arrays. 


The imnage arithmetic functions use these rules for integer arithmetic: 


e Values that exceed the range ofthe integer type are truncated to that range 


e Fractional values are rounded 


For example, ifthe datatype is uint8, results greater than 255 (includqing Inf) 
are set to 255. The following table lists some additional examples. 








Result Class Truncated Value 
300 uint8 255 

-45 Uint8 0 

10.5 Uint8 1 
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Adding Images 

To add two imnages or add a constant value to an image,usethe imadd fanction. 
imadd adds the value of each pixel in one of the input images with the 
corresponding pixel in the other input image and returns the sum in the 
corTresponding pixel ofthe output image. 


Image addition has many uses in image processing. For example, the following 
code 位 agment uses addition to Superimpose one image on top of another. The 
images must be the same size and class. 


II = imnread( rice.tif ' ) ; 

J= imread(' cameraman.tif ' ) 
K = imaddq(I,J) ; 

Imshow(K) 





You can also use addition to brighten an image by adding a constant value to 
each pixel. For example, the following code brightens an RGB imasge. 


RGB = imread( flowers.tif ) ; 
RGB2 = imadd(RGB ,50) ; 
Subplot(1,2,1); imshow(RGB) ; 
Subplot(1,2,2); imshow(RGB2) ; 


2-23 


2 Introduction 








2-24 





0riginal Image Image After Addiion 


Handling Overflow 


When you add the pixel values oftwo images,the result can easily overflow the 
maximum value Supported by the data type, especially for uint8 data. When 
overflow occurs, imadd truncates the value to the maximum value Supported by 
the data type. This is an effect known as satzra 万 o1. 了 or example, imadd 
truncates uint8 data at 255. To avoid saturation, convert the image to a larger 
data type, such as uint16, before performing the addition. 


Subtracfting Images 


To subtract one image fom another, or subtract a constant value fom an 
image, use the imsubtract function. imsubtract Subtracts each pixel value in 
one ofthe input images 位 om the corresponding pixel in the other input image 
and returns the result in the corresponding pixel in an output imasge. 


Image subtraction can be used as a preliminary step in more complex image 
processing or by itself. For example, you can use image Subtraction to detect 
changes in a series of images ofthe same scene. This code fagment subtracts 
the background from an image ofrice grains. The images mustbethe same Size 
and class， 


rice= limread( rice.tif ' ) ; 
background = imopen(rice，Sstrel('disk' ,15) ); 
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rice2 = imsubtract(rice,background ) ; 
imshow(rice) ,figure,imshow(rice2 ) ; 





0riginal image Difference Image 


To subtract a constant 位 om each pixel in I, replace Y with a constant, as in the 
following example. 


Z = imsubtract(I,50) ; 


Handling Negaftive Values 


Subtraction can result in anegative values for certain pixels. When this occurs 
with unsigned data types, Such as uint8 or uint16, the imsubtract fanction 
truncates the negative value to zero (0), which displays as black. To avoid 
negative values, but preserve the value differentiation of these pixels, use the 
imabsdiff function. The imabsdiff fanction calculates the absolute difference 
between each corresponding pixel in the two images so the result is always 
Donnegative. 


Multiplying Images 

To multiply two images, use the immultiply fanction. immultip1Ly does an 
element-by-element multiplication (.*) ofeach corresponding pixel in apair of 
input images and returns the product of these multiplications in the 
corresponding pixel in an output imasge. 


Image multiplication by a constant, referred to as scali1s, is a common image 
processing operation. When used with a scaling factor greater than one, scaling 
brightens an image; a factor less than one darkens an image. Scaling generally 
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produces a much more natural brightening/darkening effect than Simply 
adding an offset to the pixels, since it preserves the relative contrast ofthe 
image better. For example, this code scales an image by a constant factor， 


I= imread('moon.tif ' ); 
J= imnmultiply(I,1.2); 
imshow(I) ; 
figure，imshow(Jy ) 





0riginal image Image after multiplicofion 


Handling Overflow 

Multiplication of uint8 images very often results in overflow. The immultip1ly 
fonction truncates values that overflow the data type to the maximum value. 
To avoid truncation, convert uint8 images to a larger data type, Such as 
uUint16, before performing multiplication. 


2-26 


Image Arithmetic 





Dividing Images 

To divide two images, use the imdivide function. The imdivide function qdqoesg 
an element-by-element division (./) of each corresponding pixel in a pair of 
input images.The immultiply function returns the result in the corresponding 
pixel in an output image. 


Image division, like image subtraction, can be used to detect changes in two 
images. However, instead of giving the absolute change for each pixel, division 
gives the 他 actional change or ratio between corresponding pixel values. Image 
division is also called ra 万 oz7s， 


For example, the following code divides the rice grain image by a 
Imorphologically opened version of the itself. (For information about 
Imorphological image processing, see Chapter 9“Morphological Operationgs. 习 
The images must be the same size and class， 


II = imread(' rice.tif ) ; 

background = imopen(I，Sstrel('disk ,15) ) ; 
IPp = imdivide(I,background ) ; 
imshow(Ip,[]) 


Nesting Calls fo Image Arithmetic Functions 
You can use the image arithmetic functiongs in combination to perform a Seriegs 
of operations. For example, to calculate the average oftwo images， 


A4+ 叉 
艺 





C = 


You could enter 


II = imnread(' rice.tif ) ; 
I2 = imread('cameraman.tif ' ) ; 
K = imdivide(imadd(I,I2)，2); 5 not recommended 


However, when used with uint8 or Uint16 data, each arithmetic fanction 
truncates its result before passing it on to the next operation. This truncation 
can Significantly reduce the amount of information in the output image. 和 A 
better way to perform this series of calculations is to use the imLincomb 
fanction. imLincomb performs all the arithmetic operationgs in the linear 
combination in double precision and only truncates the final result. 


K = imlincomb(.5,I,.5,I2); 各 Precommended 
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Locations in an image can be expressed in various coordinate Systems， 
depending on context. This section qiscusses the two main coordinate Systems 
used in the Image Processing Toolbox, and the relationship between them. 
These two coordinate Systems are described in: 


e“Pixel Coordinates” 
e“Spatial Coordinates”on page 2-29 


Pixel Coordinates 


Generally, the most convenient method for expressing locations in an image is 
to use pixel coordinates. In this coordinate system, the image is treated as a 
grid of discrete elements, ordered 位 om top to bottom and left to right,， as 
illustrated by the following figure. 


Figure 2-6: The Pixel Coordinate System 


For pixel coordinates, the first component r (the row) increases downward， 
while the second component c (the column) increases to the right. Pixel 
coordinates are integer values and range between 1 and the length ofthe row 
or column. 


There is a one-to-one correspondence between pixel coordinates and the 
coordinates MATLAB uses formatrix subscripting.This correspondence makes 
the relationship between an image's data matrix and the way the image 
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displays easy to understand. For example, the data for the pixel in the ffth 
row, Second column is stored in the matrix element (5,2). 


Spaftial Coordinates 


In the pixel coordinate system, a pixel is treated as a discrete unit, uniquely 
identified by a single coordinate pair, such as (5,2). From this perspective, a 
location such as (5.3,2.2) is not meaningfu]. 


At times, however, it is useful to think of a pixel as a square patch. From thig 
perspective, alocation such as (5.3,2.2) zs meaningful, and is distinct 位 om (5,2). 
In this spatial coordinate system, locationgs in an image are positions on a 
plane, and they are described in terms of x andy (not Fr and c as in the pixel 
coordinate Systemy). 


The following figure illustrates the spatial coordinate system used for images. 
Notice that y increases downward. 





Figure 2-7: The Spatial Coordinate System 


This spatial coordinate System corresponds closely to the pixel coordinate 
System in many ways. For example, the spatial coordinates of the center point 
of any pixel are identical to the pixel coordinates for that pixel. 


There are some important differences, however. In pixel coordinates, the 
Upper-left corner of an imasge is (1,1), while in spatial coordinates, this location 
by default is (0.5,0.5). This difference is due to the pixel coordinate system 
being discrete, while the spatial coordinate System is continuous. Also, the 
Upper-left corner is always (1,1) in pixel coordinates, but you can Specify a 
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nondefault origin for the spatial coordinate system. See“Using a Nondefault 
Spatial Coordinate System”on page 2-30 for more information. 


Another potentially confusing difference is largely a matter of convention: the 
order ofthe horizontal and vertical components is reversed in the notation for 
these two Systems. As mentioned earlier, pixel coordinates are expressed as 
(r;c), while spatial coordinates are expressed as (Xx,y). In the reference pages， 
when the syntax for a function uses r and c, it refers to the pixel coordinate 
System. When the syntax uses x and y, it refers to the spatial coordinate 
System . 


Using a Nondefault Spafial Coordinate System 

By default, the spatial coordinates of an image correspond with the pixel 
coordinates. For example, the center point of the pixel in row 5, column 3 has 
spatial coordinates x=3, y=5. (Remember, the order of the coordinates is 
reversed.) This correspondence simplifies many of the toolbox functions 
considerably. Several functions primarily work with spatial coordinates rather 
than pixel coordinates, but as long as you are using the default spatial 
coordinate System, you can Specify locationgs in pixel coordinates. 


In some Situations, however, you may want to use a nondefault spatial 
coordinate system. For example, you could specify that the upper-left corner of 
an image is the point (19.0,7.5), rather than (0.5,0.5). Ifyou call a function that 
returns coordinates for this image, the coordinates returned will be values in 
this nondefault spatial coordinate System. 


To establish a nondefault spatial coordinate system, you can specify the XData 
and YData image properties when you display the image. These properties are 
two-element vectors that control the range of coordinates spanned by the 
image. By default, for an image A, XData is [1 size(A,2)], and YData is 

[1 Size(A,1)]. 


For example, 计 Ais a 100 row by 200 column image, the default XData is 

[1 200], and the default YData is [1 100]1. The values in these vectors are 
actually the coordinates for the center points ofthe first and last pixels (not the 
pixel edges), so the actual coordinate range spanned is slightly larger; for 
instance, 让 XData is [1 200], the x-axis range Spanned by the image is 

[0.5 200.5]. 


These commands display an image using nondefault XData and YData. 


A=magic(5); 
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X [19.5 23.5]; 
y = [8.0 12.0]; 
image(A，XData' ,X，YData' ,y)，axis image，colormap (jet(25)) 





19 195 20 205 21 215 22 225 23 235 24 


For information about the syntax variations that specify nondefault spatial 
coordinates, see the reference page for imshow，. 
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This section introduces the image display techniques Supported by the Image Processing Toolbox for 
each image type Supported by the toolbox (e.g., RGB, intengsity). Topics covered include 


Terminology (p. 3-2) 


Displaying Images (p. 3-3) 


Special Display Techniques (p. 3-12) 


Setting Toolbox Display Preferences 
(p. 3-23) 


Zooming in on a Region of an Image 
(p. 3-26) 


Texture Mapping (p. 3-28) 


Printing Images (p. 3-29) 
Troubleshooting (p. 3-30) 


Provides definitions of image processing terms used in 
this section 


Describes how to use the imshow function to display all 
types of images 


Describes hovw to display multiframe images or include a 
colorbar with an image 


Describes hovw to set preferences that impact toolbox 
display fanctions 


Describes hovw to zoom in and out on an image 


Describes hovw to map an image onto a parametric 
Surface, Such as a Sphere, or below a surface plot 


Describes how to print an image 位 om within MATLAB 


Provides tips about handling common image display 
problems 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms Definitions 





Color approximaftion There are two ways in which this term is used in MATLAB: 


e The method by which MATLAB chooses the best colors for 
an image whose number of colors you are decreasing 


e The automatic choice ofscreen colors MATLAB makes when 
displaying on a system with limited color display capability 


Screen bif depth The number of bits per Screen pixel 
Screen color resolution The number of distinct colors that can be produced by the 
Screen 
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Displaying Images 


In MATLAB,the primary wayto display images is by using the image function 
This function creates a Handle Graphics@ image object, and it includes syntax 
for setting the various properties of the object. MATLAB also includes the 
imagesc fanction, which is similar to image but which automatically scales the 
input data. 


The Image Processing Toolbox includes an additional display routine called 
imshow. Like image and imagesc, this function creates a Handle Graphics 
image object. However, imshow also automatically sets various Handle 
Graphics properties and attributes of the image to optimize the display. 


This section discusses displaying images using imshow. In general, using 
imshow for image processing applications is preferable to using image and 
imagesc. It is easier to use and in most cases, displays an image using one 
image pixel per Screen pixel. (For more information about image and imagesc， 
see their pages in the MATLAB Function Reference or see the MATLAB 
graphics documentation.) 





Note One ofthe most common toolbox usage erTors is using the wITong Syntax 
of imshow for your image type. This chapter shows which syntax is appropriate 
for each type of image. If you need help determining what type ofimage you 
are Working with, see“Image Types in the Toolbox”on page 2-5. 





Displaying Indexed Images 
To display an indexed image with imshow, specify both the image matrix and 
the colormap. 


Imshow(X,map) 


For each pixel in X, imshow displays the color stored in the corresponding row 
of map. The relationship between the values in the image matrix and the 
colormap depends on whether the image matrix is of class double, uint16, or 
uint8. Ifthe imnage matrixis ofclass double, the value 1 points to the first row 
in the colormap, the value 2 points to the second row, and so on. Ifthe image 
matrix is ofclass uint8 or Uint16, there is an offset; the value 0 points to the 
first row in the colormap, the value 1 points to the second row, and so on. (The 
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offset is handled automatically by the image object, and is not controlled 
through a Handle Graphics property.) 


imshow directly maps each pixel in an indexed imasge to its corresponding 
colormap entry. Ifthe colormap contains a greater number of colors than the 
image, imshow ignores the extra colors in the colormap. Ifthe colormap 
contaings fewer colors than the imagerequires, imshow sets all image pixels over 
the limits ofthe colormap;s capacity to the last color in the colormap. For 
example,ifan image ofclass uint8 contains 256 colors, and you display it with 
a colormap that contains only 16 colors, all pixels with a value of 15 or higher 
are displayed with the last color in the colormap. 


The Image and Axes Properties of an Indexed Image 


When you display an indexed image, imshow sets the Handle Graphics 
properties that control how colors display, as follows: 


e The image CData property is set to the data in X. 
e The image CDataMapping property is set to direct. 


e The axes CLim property does not apply, because CDataMapping is set to 
direct. 


e The figure Colormap property is set to the data in map. 


Displaying Intensity Images 
To display a intensity (grayscale) image, the most basic Syntax is 


imshow(I) 


imshow displays the image by scalLimnsg the intensity values to Serve as indices 
into a grayscale colormap. If Iis double, a pixel value of 0.0 is displayed as 
black, a pixel value of 1.0 is displayed as white, and pixel values in between are 
displayed as shades of gray. IfIis uint8,then a pixel value of255 is displayed 
as white. IfIis uint16, then a pixel value of 65535 is displayed as white. 


Intensity images are Similar to indexed images in that each uses an m-by-3 
RGB colormap, but normally, you will not specify a colormap for an intensity 
image. MATLAB displays intensity images by using a grayscale System 
colormap (where R=G=B). By default, the number of levels of gray in the 
colormap is 256 on Systems with 24-bit color, and 64 or 32 on other Systems， 
(See“Working with Different Screen Bit Depths”on page 13-3 for a detailed 
explanation.) 
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Another syntax form of imshow for intensity images enables you to explicitly 
specify the number of gray levels to use. To display an image I with 32 gray 
levels, specify a value for n. 


imshow(I,32) 


Because MATLAB scales intensity images to fill the colormap range, a 
colormap of any size can be used. Larger colormaps enable you to see more 
detail, but they also use up more color slots. The availability of color slots is 
discussed further in “Displaying Multiple Images”on page 3-17, and also in 
“Working with Different Screen Bit Depths”on page 13-3. 


Displaying Intensity Images That Have Unconventiona| Ranges 

In some cases, you may have data you want to display as an intensity image， 
even though the data is outside the conventional toolbox range (ie., [0,1] for 
double arrays, [0,255] for uint8 arrays, or [0,65535] for uint16 arrays). For 
example, 坟 you filter an intengsity image, some ofthe output data may fall 
outside the range of the original data. 


To display unconventional range data as an image, you can specify the data 
range directly, using 


imshow(I,[1Low high]) 


H 开 you use an empty matrix ([]) for the data range, imshow Scales the data 


automatically, setting low and high to the minimum and maximum values in 


the arTray. The next example filters an intengsity image, creating 
unconventional range data. imshow is then called using an empty matrix. 


II = imnread( ' testpat1.tif ' ) ; 
J = filter2([1 2;-1 -2],I); 
imshow(J，[]); 
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When you use this syntax,，imshow sets the axes CLim property to [min(J(:)) 
max(J(:))]. CDataMapping is always scaled for intensity images, so that the 
value min(J(:)) is displayed using the first colormap color, and the value 
max(J(:)) is displayed using the last colormap color. 


The Image and Axes Properfies of an Intensity Image 

When you display an intensity image, imshow sets the Handle Graphics 
properties that control how colors display, as followsgs: 

e The image CData property is set to the data in 工 . 

e The image CDataMapping property is set to scaled. 


e The axes CLim property is set to [0 1] 让 the image matrix is of class doub1le， 
[0 255] 放 the matrix is ofclass uint8, or [0 65535] ifit is of class uint16. 


e The figure Colormap property is set to a grayscale colormap whose values 
range from black to white. 


Displaying Binary Images 
To display a binary image, the syntax is 


BW = imread(' circles.tif' ) ; 
Imshow(BW) 
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In MATLAB, abinary imageils ofclass 1ogical.Binary imnages contain only 0'S 
and 1s. Pixels with the value 0 display as black; pixels with the value 1 display 
as White. 





Nofte For the toolbox to interpret the image as binary it must be of class 
1ogical. Intensity images that happen to contain only 0's and ls are not 
binary images. 





Changing the Display Colors of a Binary Image 

You may prefer to invert binary images when you display them, so that 0 
values display as white and 1 values display as black. To do this, use the NOT 
(~) operator in MATLAB. (In this example, abox is drawn around the image to 
show the image boundary.) For example， 


Imshow(~BW) 
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You can also display a binary image using a colormap. For example, the 
following command displays 0?s as red and ls as blue. 


imshow(BW,[1 0 0; 001]) 





Reading and Writing Binary Images 

In certain file formats, a binary image can be stored in a 1-bit format. When 
youread in a binary image in 1-bit format, MATLAB represents it in the 
WwWorkspace as a 10gical arTray. 


By default, MATILAB writes binary images as 1-bit imnages, 这 the file format 
SUpports it. 


Imwrite(BW，test.tif'); “#% MATLAB Supports writing 1-bit TIFFs . 
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To verify the bit depth oftest.tif,call imfinfo.As you will see, the BitDepth 
field indicates that it has been saved as a 1-bit image, with the beginning of 
your output looking something like this. 


Imfinfo( test.tif') 
ans = 
Filename: 'd:\mystuff\grid.tif， 
FileModDate: '`25-Nov-1998 11:36:17， 
FileSize: 340 
Format: “七 f， 


FormatVersion: [] 

Width: 20 

Height: 20 
BitDepth: 1 


ColorType: “graySscale， 
FormatSignature: [73 73 42 01] 
Byteorder: '1ittle-endian' 
NewSubfileType: 0 
BitsPerSampJe: 1 
Compression: "CCITT 1D， 





Nofte You may have noticed that the ColorType field ofthe binary image 
queried above has a value of 'grayscale'. MATLAB sets this field to one of 
three values: 'grayscale'，'indexed' ,and 'truecolor'. When reading an 
image, MATLAB evaluates the image type by checking both the BitDepth and 
the ColorType fieldqs. 





The Image and Axes Properfies of a Binary Image 

imshow sets the Handle Graphics properties that control how colors display, as 
follows: 

e The image CData is set to the data in BW. 

e The image CDataMapping property is set to direct. 

e The axes CLim property is set to [0 1]. 


e The figure Colormap property is set to a grayscale colormap whose values 
range 位 om black to white. 


3-9 


3 Displaying and Prinfing |mages 





3-10 


Displaying RGB Images 
RGB images, also called 妨 xecolor images, represent color values directly， 
rather than through a colormap. 


To display an RGB image, the most basic syntax is 
imshow(RGB ) 


RGB is m-by-n-by-3 array. For each pixel (rc) in RGB, imshow displays the color 
represented by the triplet (rc,1:3). 


Systems that use 24bits per Screen pixel can display truecolor images directly， 
because they allocate 8 bits (256 levels) each to the red, green, and blue color 
planes. On systems with fewer colors, MATLAB displays the image using a 
combination ofcolor approximation and dithering. See“Working with Different 
Screen Bit Depths”on page 13-3 for more information. 


The Image and Axes Properties of an RGB Image 
When you display an RGB image, imshow sets the Handle Graphics properties 
that control how colors display, as follows: 


e The image CData property is set to the data in RGB. The data will be 
three-dimensional. When CData is three-dimensional, MATLAB interprets 
the array asgs truecolor data, and jignores the values ofthe CDataMapping， 
CLim, and Colormap properties. 


e The image CDataMapping property is ignored. 
e The axes CLim property is ignored. 
e The figure Colormap property is jignored. 
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Displaying Images Direcftly from Disk 

Generally, when youwantto display an image,you will first use imread to load 
it and the data is stored as one or more variables in the MATLAB workspace. 
However, 让 you do not want to load an image directly before displaying it, you 
can display a file directly using this Syntax. 


imshow filename 
The file must be in the current directory or on the MATLAB path. 


For example, to display a file named flowers .tif， 


Imshow Tf1Lowers .tif 


Ifthe image has multiple 人 ames, imshow will only display the first 位 ame. For 
information on the display options for multiframe images, see“Displaying 
Multiframe Images”on page 3-13. 


This syntax is very useful for scanning through images. Note, however, that 
when you use this syntax, the image data is not stored in the MATLAB 
workspace. 玉 you want to bring the image into the workspace, use the 
getimage function, which gets the image data from the current Handle 
Graphics image object. For example， 


rgb = getimage 


will assign flowers.tif to rgb 让 the figure window in which it is dqisplayed is 
currently active. 
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Special Display Techniques 


In addition to imshow, the toolbox includes functions that perform specialized 
display operations, or exercise more direct control over the display format. 
These functions, together with the MATLAB graphics fanctions, provide a 
range of imnage display options. 


This section includes the following topics: 


e“Addqing a Colorbar”on page 3-12 

se“Displaying Multiframe Images”on page 3-13 
e“Displaying Multiple Images”on page 3-17 
e“Zooming in on a Region of an Image”on page 3-26 
e“Texture Mapping”on page 3-28 


Adding a Colorbar 


Use the colorbar function to add a colorbar to an axes object. Iyou add a 
colorbar to an axes object that contains an image object, the colorbar indicates 
the data values that the different colors in the image correspond to. 


Seeing the correspondence between data values and the colors displayed by 
using a colorbar is especially useful 计 you are displaying unconventional range 
data as an image, as described under “Displaying Intengsity Images That Have 
Unconventional Ranges”on page 3-5. 


In the example below, a grayscale image of class uint8 is filtered, resulting in 
data that is no longer in the range [0,255]. 


I= imread('Saturn.tif ' ) ; 
h= [121;)000;j -1 -2 -1]| 
I2 = filter2(h,I); 
imshow(I2,[])，colorbar 
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Displaying Multiframe Images 

Amultiframe image is an image file that contains more than one image. The 
MATLAB-supported formats that enable the reading and writing of 
multiframe images are HDF and TIFF. See“Multiframe Image Arrays”on 
page 2-11 for more information about reading and writing multiframe images. 


Once read into MATLAB, the image frames ofa multiframe image are always 
handled in the fourth dimension. Multiframe images can be loaded from disK 
using a Special syntax of imread, or created using MATLAB. Multiframe 
images can be qisplayed in several different waysi to display a multiframe 
Image, you camn 


e Display the frames individually, using the imshow function. See“Displaying 
the Frames of a Multiframe Image Indqividually”on page 3-14 below. 

se Display all ofthe 位 ames at once,using the montage fanction. See“Displaying 
All Frames of a Multiframe Image at Once”on page 3-15. 

e Convert the fames to a movie, using the immovie function. See“Converting 
a Multiframe Image to a Movie”on page 3-16. 
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Displaying fhe Frames of ao Mulfiframe Image Individually 

In MATLAB, the frames ofa multiframe image are handled in the fourth 
dmension. To view an individual 他 ame, call imshow and specify the 位 ame 
using standard MATLAB indexing notation. For example, to view the seventh 
位 ame in the intengsity array I， 


imshow(I(:，:，:,7)) 


The following example loads mri.tif and displays the third 人 fame. 


s%5 Initialize an array to hold the 27 frames of mrI.tif 
mriz = Uint8(zeros(128,128,1,27) ) ; 
for frame=1:27 
%5 Read each frame into the appropriate frame in memory 
[mri(:,:， :frame),map]l] = imread('mri.tif' frame) 
end 
imshow(mrz(:,，:， :3),map) 





Intensity, indexed, and binary multiframe images have a dimension of 
m-by-n-by-1-by-k, where k represents the total number of frames, and 1 
signifies that the image data has just one color plane. Therefore, the following 
cal],， 


imshow(mriz(:,，:，:，3) ,map) 
is equivalent to， 
imshow(mriz(:,，:,， 1, 3) ,map); 


RGB multiframe images have a dimension of m-by-n-by-3-by-k, where 
represents the total number offrames, and 3 signifies the existence ofthe three 
color planes used in RGB images. This example， 


imshow(RGB(:，:，:),，7) ); 


Special Display Techniques 





showsgs all three color planes of the seventh frame, and is not equivalent to 
imshow(RGB(:，,:,3,7) ) 


which shows only the third color plane (blue) of the seventh 位 ame. These two 
calls will only yield the same results 让 the image is RGB grayscale (了 =G=B). 


Displaying All Frames of ao Mulfiframe Image at Once 


To view all ofthe fames in a multi 们 ame array at one time, use the montage 
fanction. montage divides a figure into multiple display regions and displays 
each image in a separate region. 


The syntax for montage is similar to the imshow syntax. To display a 
multiframe intensity image, the syntax is 


montage(I) 
To display a multiframe indexed image, the syntax is 


montage(X,map) 





Note All ofthe fames in a multiframe indexed array must use the same 
colormap. 





This example loads and displays all frames of a multiframe indexed image. 


5 Initialize an array to hold the 27 frames of mri.tif， 
mri = Uint8(zeros(128,128,1,27) ) ; 
for frame=1:27 
#%5 Read each frame into the appropriate frame in memory ， 
[mrz(:,，:， :frame),map]l] = imread('mri.tif' frame) 
end 
montage(mri,map) ; 
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Figure 3-1: All Frames of Multiframe Image Displayed in One Figure 


Notice that montage displays images in a row-wise manner. The first 位 ame 
appears in the first position ofthe first row, the next frame in the second 
position ofthe first row, and so on. montage arranges the frames so that they 
roughly form a square， 


Converting a Mulfiframe Image to a Movie 
To create a MATLAB movie 人 om a multiframe image array, use the immovie 
fonction. 


This call creates a movie 们 om a multiframe indexed image X 


mov = Immovie(Xx,map) ; 
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where X is a four-dimensional array of images that you wantto use for the 
movie， 


You can play the movie in MATLAB using the movie function. 


movie(mov) ; 


This example loads the multiframe image mri.tif andmakes amovie out of 让 . 
It wont do any good to show the results here, so try it out; it's fan to watch. 


5 Initialize and array to hold the 27 frames of mri.tif， 
mri = Uint8(zeros(128,128,1,27) ) ; 
for frame=1:27 
#%5 Read each frame into the appropriate frame in memory ， 
[mrz(:,:， :frame)map]l] = imread( mri.tif' frame) 
end 


mov = immovie(mrimap); 
movie(mov) ; 


Note that immovie displays the movie as it is being created, so you will actually 
see the movie twice. The movie runs much faster the second time (using movie). 





Note MATLAB movies require MATLAB in order to be run. To make a movie 
that can be run outside of MATLAB, you can use the MATLAB avifile and 
addframe functions to create an AVIfile. AVI files can be created using 
indexed and RGB images of classes uint8 and double, and don't require a 
multiframe image. For instructions on creating an AVIfile, see the 
Development Environment section in the MATLAB documentation. 





Displaying Mulfiple Images 

MATLAB does not place any restrictions on the number of images you can 
display simultaneously. However, there are usually system limitations that 
are dependent on the computer hardware you are using. The sectiongs below 
describe hovw to display multiple figures separately, or within the same figure. 


The main limitation is the number of colors your System can display. This 
number depends primarily on thenumber ofbits that are used to store the color 
information for each pixel. Most systems use either 8, 16, or 24 bits per pixel. 
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HIyou are using a system with 16 or 24 bits per pixel, you are unlikely to run 
into any problems, regardless of the number of images you display. However， 
过 your System uses 8 bits per pixel, it can only display a maximum of 256 
different colors, and you can therefore quickly run out of color slots 证 you 
display multiple images. (Actually, the total number of colors you can display 
is slightly fewer than 256, because some color slots are reserved for Handle 
Graphics objects. The operating system usually reserves a few colors as wel].) 


To determine the number ofbits per pixel on your system, enter this command. 
get(0，ScreenDepth  ) 


See “Working with Different Screen Bit Depths”on page 13-3 for more 
information , 


This section qiscusses: 


e Displaying each image in a separate figure 
se。 Displaying multiple images in the same fgure 


LI also includes information about working around system limitations， 


Displaying Each Image in a Separate Figure 


The simplest way to display multiple images is to display them in different 
fgure windows. imshow always displays an image in the current 和 gure, so 让 
you display two images in Succession, the second image replaces the first 
image. To avoid replacing the image in the current figure, use the figure 
command to explicitly create a new empty fgure before calling imshow for the 
next image. For example， 


imshow(I) 
figure，imshow(I2) 
figure，imshow(I3) 


When you use this approach, the figures you create are empty initially. 


HIyou have an 8-bit display, you must make sure that the total number of 
colormap entries does not exceed 256. For example, 计 you try to display three 
images, each having a different colormap with 128 entries, at least one of the 
images will display with the wrong colors. (If all three images have identical 
colormaps, there will not be a problem, because only 128 color slots are used.) 
Remember that intensity images are also displayed using colormaps, so the 
color slots used by these images count toward the 256-color total. 


Special Display Techniques 





In the next example, two indexed images are displayed on an 8-bit display. 
Since these images do not have similar colormaps and due to the limitation of 
the Screen color resolution, the first image is forced to use the colormap of the 
second image, resulting in an inaccurate display. 


[X1,map1]=imread( ' forest.tif ' ); 
[X2 ,map2]=imread( trees.tif ) ; 
Imshow(X1,map1) ,figure,imshow(X2,map2 ) ; 





Figure 3-2: Displaying Two Indexed Images on an 8-bit Screen 


As X2 is displayed, X1 is forced to use X2:s colormap (and now you cant see the 
forest for the trees). Note that the actual display results of this example will 
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vary depending on what other application windows are open and using up 
System color Slots. 


One way to avoid these display problems is to manipulate the colormaps to use 
fewer colors. There are various ways to do this, such as using the imapprox 
fonction. See“Reducing the Number of Colors in an Image”on page 13-6 for 
information . 


Another solution is to convert images to RGB (truecolor) format for display， 
because MATLAB automatically uses dithering and color approximation to 
display these images. Use the ind2rgb function to convert indexed images to 
RGB. 


imshow(Iind2rgb(X;,map)) 


Or, simply use the cat command to display an intensity image as an RGB 
image. 


Imshow(cat(3,I,I,I)) 


Displaying Mulfiple Images in the Same Figure 
You can display multiple images in a single figure window with some 
limitations. This discussion shows you how to do this in one oftwo waysS: 


1 By using imshow in conjunction with subp1lot 


2 By using subimage in conjunction with subp1lot 


subplot divides a figure into multiple display regions. The syntax of subp1lot is 
Subplot(m,ny;,p) 


This syntax divides the figure into an m-by-n matrix of display regions and 
makes the pth display region active. 


For example, 这 you want to display two images side by side, use 
[X1,map1]=imread('forest.tif ) ; 
[X2 ,map2]=imread( ' trees.tif ' ) ; 


Subplot(1,2,1)，imshow(X1,map2) 
Subplot(1,2,2)，imshow(X2,map2) 


Special Display Techniques 
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Figure 3-3: Two Images in Same Figure Using the Same Colormap 


Ifsharing a colormap (using the subplot function) produces unacceptable 
display results as Figure 3-3 shows, use the subimage function (Shown below). 
Or, as another alternative,youcan map all images to the same colormap as yoU 
load them. S$ee“Colormap Mapping”on page 13-11 for more information. 


subimage converts images to RGB before displaying and therefore circumvents 
the colormap sharing problem. This example displays the same two images 
shown in Figure 3-3 with better results. 


[X1,map1]=imread( ' forest.tif ) ; 
[X2,map2]=imread( trees.tif ) ; 
Subplot(1,2,1)，Ssubimage(X1,map1) 
Subplot(1,2,2)，Subimage(X2,map2) 
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Figure 3-4: Two Images in Same Figure Using Separafte Colormaps 
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Setting Toolbox Display Preferences 


The behavior of imshow is influenced in part by the current settings of the 
ioolpox prejeremces. Depending on the arguments you specify and the current 
settings ofthe toolbox preferences, imshow may: 

e Suppress the display of axes and tick marks. 

e Include or omit a“border”around the imasge. 

se Call the truesize function to display the image without interpolation , 

e Set other figure and axes properties to tailor the display. 

All ofthese settings can be changed by using the iptsetpref fanction.The 
truesize preference can also be changed by setting the display_option 


parameter of imshow. This section describes how to set the toolbox preferences 
and how to use the display_option parameter. 


When you display an image using the imshow function, MATLAB also sets the 
Handle Graphics figure, axes, and image properties, which control the way 
image data is interpreted. These settings are optimized for each imasge type, 
The specific properties set are described under the following sectionsg: 

e“The Image and Axes Properties of an Indexed Image”on page 3-4 

se“The Image and Axes Properties of an Intensity Image”on page 3-6 

e“The Image and Axes Properties of a Binary Image”on page 3-9 

e“The Image and Axes Properties of an RGB Image”on page 3-10 


Toolbox Preferences 


The toolbox preferences affect the behavior of imshow for the duration ofthe 
current MATLAB session. You can change these settings at any time by using 
the iptsetpref function. To preserve your preference settings from one session 


3-23 


3 Displaying and Prinfing |mages 





3-24 


to the next, make your settings in your startup .m file. These are the 
preferences that you may set. 





Toolbox Preference Descripftion 





ImshowBorder Controls whether imshow displays the fgure 
window as largerthan the image (leaving a border 
between the image axes and the edges ofthe 
figure), or the same size as the image (leaving no 
border). 


ImshowAxesVisib1le Controls whether imshow displays images with the 
axes box and tick labels. 


ImshowTruesize Controls whether imshow calls the truesize 
fonction. This preference can be overridden for a 
single call to imshow; see“Using the truesize 
Function”belovw for more details 


TrueSizeWarning Controls whether you will receive a warning 
message 让 an image is too large for the screen. 





This example call to iptsetpref resizes thefigure window sothatitfits tightly 
around displayed images. 


iptsetpref(' ImshowBorder ， tight ' ) ; 


To determine the current value of a preference, use the iptgetpref fanction. 


For more information about toolbox preferences and the values they accept, see 
the reference entries for iptgetpref and iptsetpref. 


Using fhe truesize Function 


The truesize function assigns a single screen pixel to each image pixel, e.g., a 
200-by-300 image will be 200 screen pixels in height and 300 Screen pixels in 
width. This is generally the preferred way to display an image. In most 
Situations, when the toolbox is operating under default behavior, imshow calls 
the truesize command automatically before displaying an image. 


In some cases, you may not want imshow to automatically call truesize (for 
example, 过 you are working with a small image). Iyou display an image 


Setting Toolpbox Disploy Preferences 





without calling truesize, the image displays at the default axis size. In such 
cases, MATLAB must use ;zterpolatizomn to determine the values for screen 
pixels that do not directly correspond to elements in the image matrix. (See 
“Interpolation”on page 4-3 for more information.) 


You can affect whether MATLAB automatically calls truesize by using either 
of these methods: 


e Set the preference for the current MATLAB session. This example sets the 
ImshowTruesize preference to 'manual ' , meaning that truesize will not be 
automatically called by imshow. 


iptsetpref( ' ImshowTruesize ，manual ') 


e Set the preference for a single imshow command by setting the 
display_ option parameter. This example sets the display_option 
parameter to truesize, so that truesize is called for the image displayed， 
regardless ofthe current preference setting. 


Imshow(X，map，truesize ') 


For more information see the reference descriptiongs for imshow and truesize. 
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The simplest way to zoom in on aregion of an image is to use the zoom buttongs 
provided on the figure window. To enable zooming 位 om the command line, use 
the zoom command.When you zoom in, the figure window remains the same 
size, but only a portion ofthe image is displayed, at a higher magnification . 
(zoom works by changing the axis limits; it does not change the image data in 
the fgure.) 


Once zooming in is enabled, there are two ways to zoom in on an image: 


1 Single mouse click: click on a spot in the image by placing the cursor on the 
spot and the pressing the left mouse button. The image is magnified and the 
center of the new View is the spot where you clicked. 


2 Cjlick and drag the mouse: select a region by clicking on the image, holding 
down the left mouse button, and dragging the mouse. This creates a dotted 
rectangle. When you release the mouse button, the region enclosed by the 
rectangle is displayed with magnification 


Zooming In or Outf with the Zoom Bufttons 
The zoom buttongs in the MATLAB figure enable you to zoom in or out on an 
image using your mouse. 


To zoom in, click the “magnifying glass”button with the plus sign in 让 . 
包 There are two ways to zoom in on an image after selecting the zoom in 
button. See “Zooming in on a Region of an Image”above. 


To zoom out, click the “magnifying glass”button with the minus sign in 
局 it. Click your left mouse button overthe spot in the image you would like 
to zoom out 位 om. 


Zooming In or Out from the Command Line 


The zoom command enables you to zoom in or out on an image using yourT 
Imouse， 


To enable zooming (in or out), type 


ZOom on 


Zooming in on a Region of an Image 





There are two ways to zoom in on an image. See “Zooming in on a Region of an 
Image”on page 3-26. 


To zoom out, click on the image with the right mouse button. (Ifyou have a 
single-button mouse, hold down the Shift key and click.) 


To zoom out completely and restore the original view, enter 


ZOom Out 


To disable zooming, enter 


ZOom off 
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Texture Mapping 


When you use the imshow command, MATLAB displays the image in a 
two-dimensional view. However, it is also possible to map an image onto a 
parametric surface, such as a Sphere, or below a surface plot. The warp function 
creates these qisplays by textzre apping the image. Texture mapping is a 
process that maps an image onto a Surface grid using interpolation. 


This example texture maps an image of a test pattern onto a cylinder. 


[xy,z] = Cylinder 
I= imread('testpat1.tif' ) ; 
warp(x,y,Z, 工 ) ; 








Figure 3-5: An Image Textiure Mapped onto a Cylinder 


The imagemaynot map onto the surface in the waythat youhad exzpected. One 
way to modify the way the texture map appears is to change the settings ofthe 
xdir,Ydir, and zdir properties. For more information, see Changing Axis 
Direction in the MATLAB Graphics documentation , 


For more information about texture mapping, see the reference entry for the 
warp fanction. 
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Prinfing Images 


Ifyou want to output a MATLAB image to use in another application (Such as 
a Word-processing program or graphics editor), use imwrite to create a file in 
the appropriate format. See“Writing a Graphics Image”on page 2-17 for 
details. 


Ifyou want to print the contents ofa MATLAB figure (including nonimage 
elements such as labels), use the MATLAB print command, or choose the 
Print option 他 om the File menu ofthe figure window. Note thatifyou produce 
output in either ofthese ways, the results reflect the settings ofvarious Handle 
Graphics properties. In some cases, you may need to change the settings of 
certain properties to get the results you want. 


Here are some tips that may be helpful when you print images: 


e Image colors print as shown on the Screen. This means that images are not 
affected by the InvertHardcopy figure property. 


e To ensure that printed images have the proper Size and aspect ratio， 
you Should set the figure's PaperPositionMode property to auto. When 
PaperPositionMode is set to auto, the width and height ofthe printed figure 
are determined by the figure's dimensions on the Screen. By default, the 
value of PaperPositionMode is manual. Ifyou want the default value of 
PaperPositionMode to be auto, you can add this line to your startup .mfile. 


Set(0，DefaultFigurePaperPositionMode ' ，auto ') 


For detailed information about printing with File/Print or the print command 
(and for information about 了 andle Graphics), see“Printing and 玉 xporting 
Figures with MATLAB”in the MATLAB Graphics documentation. For a 
complete list of options for the print command, enter help print at the 
MATLAB command line prompt or see print in the MATLAB Function 
Reference. 
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Troubleshoofting 


This section contaings three common Scenarios (in bold text) which can occur 
unexpectedly, and what you can do to derive the expected results. 


Color Image Displays as Grayscale 
Ifa color image qisplays as a grayscale image, it can indicate that the image is 
an indexed image and you have not specified the associated colormap， 


To display an indexed image using imshow, you must specify the colormap， 
Using this Syntax: 


imshow(X,map ) ; 
You should also make sure that you used the correct Syntax for loading an 
indexed image, which is， 


[X，map]=imread( ' filename.ext ' ) ; 


For more information about displaying indexed images, see “Displaying 
Indqexed Images”on page 3-3. 


Displaying Mulfiframe Images 


HIyou load a multiframe image and display it, MATLAB only displays one 
位 ame. 


To view the other fames in a multiframe image, you must load each frame 
separately. This can be done using a for loop. It may be helpful to first use 
imfinfo to fnd out how many fames the image file contains, and what their 
dmensions are. To see an example, go to “Displaying the Frames of a 
Multiframe Image Indqividually”on page 3-14. 





Spatial Transformations 





This section describes the spatial transformation functions in the Image Processing Toolbox. Spatial 
transformations map pixel locations in an input image to new locations in an output image. Topics 


covered include 


Terminology (p. 4-2) 


Interpolation (p. 4-3) 


Image Resizing (p. 4-5) 


Image Rotation (p. 4-8) 


Image Cropping (p. 4-10) 


Performing General Spatial 
Transformations (p. 4-12) 


Provides definitions of image processing terms used in 
this section 


Defines interpolation, the process used to estimate the 
value of a pixel in an output image when that pixel does 
not appear in the input image 


Describes how to use the imresize function to change the 
Size of an image 


Describes hovw to use the imrotate function to rotate an 
image 

Describes hovw to use the imcrop function to extract a 
rectangular portion of an image 


Describes the general spatial transformation capabilities 
of the toolbox 


4 Spotial Transformations 





4-2 


Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


Definitions 





Aliasing 


Anti-aliasing 


Bicubic interpolation 


Bilinear inferpolaftion 


Geometric operation 


Interpolation 


Nearest neighbor 
inferpolaftion 


Artifacts in an image that can appear as a 
result ofreducing an image'”s Size. When the 
Size of an image is reduced, original pixels 
are downsampled to create fewer pixels. 
Aliasing that occurs as a result of size 
reduction normally appears as“stair-step” 
patterns (especially in high contrast images)， 
or as8“Moire”(ripple-effect) patterns. 


Any method for correcting aliasing (see 
above). The method discussed in this chapter 
is low-passgs fltering (see below). 


Output pixel values are calculated from a 
weighted average of pixels in the nearest 
4-by-4 neighborhood. 


Output pixel values are calculated from a 
weighted average of pixels in the nearest 
2-by-2 neighborhood. 


An operation that modifies the spatial 
relations between pixels in an image. 
卫 xamples include resizing (growing or 
shrinking), rotating, and shearing. 


The process by which we estimate an image 
value at a location in between image pixels. 


Output pixel values are assignedthe value of 
the pixel that the point falls within. No other 
pixels are considered. 





Interpolation 





Interpolation 


Interpolation is the process by which we estimate an image value at a location 
in between image pixels. For example, 让 you resize an image so it contaings 
more pixels thanit did originally,the software obtains values forthe additional 
pixels through interpolation. The imresize and imrotate geometric faunctiongs 
use two-dimensional interpolation as part ofthe operations they perform. (The 
improfile image analysis fanction also uses interpolation. See“Intensity 
Profile”on page 10-4 for information about this function.) 


The Image Processing Toolbox provides three interpolation methods: 


e Nearest neighbor interpolation 
e Bilinear interpolation 


e Bicubic interpolation 


The interpolation methods all work in a fundamentally similar way. In each 
case, to determine the value for an interpolated pixel, you find the point in the 
input image that the output pixel corresponds to. You then assign a value to 
the output pixel by computing a weighted average of some set of pixels in the 
Vicinity ofthe point. The weightings are based on the distance each pixel is 
位 om the point.， 


The methods differ in the set of pixels that are considered: 


e For nearest neighbor interpolation, the output pixel is assigned the value of 
the pixel that the point falls within. No other pixels are considered. 


e For bilinear interpolation, the output pixel value is a weighted average of 
pixels in the nearest 2-by-2 neighborhood. 


e For bicubic interpolation, the output pixel value is a weighted average of 
pixels in the nearest 4-by-4 neighborhood. 


The number of pixels considered affects the complexity of the computation. 
Therefore the bilinear method takes longer than nearest neighbor 
interpolation, and the bicubic method takes longerthan bilinear. However, the 
greater the number of pixels considered, the more accurate the effect is, so 
there is a trade-off between processing time and quality. 
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Image Types 


The functions that use interpolation take an argument that specifies the 
interpolation method. For most of these functions, the default method is 
nearestneighbor interpolation. This method produces acceptable resujlts for all 
imagetypes, and is the only methodthat is appropriate for indexed images. For 
intengsity and RGB images, however, you should generally specify bilinear or 
bicubic interpolation, because these methods produce better results than 
nearest neighbor interpolation. 


For RGB images, interpolation is performed on the red, green, and blue image 
planes individually. 


For binary images, interpolation has effects that you should be aware of. 开 you 
use bilinear or bicubic interpolation, the computed values for the pixels in the 
output image will not all be 0 or 1. The effect on the resulting output image 
depends on the class ofthe input image: 


e Ifthe class ofthe input image is double, the output image is a grayscale 
image of class double. The output image is not binary, because it includes 
values other than 0 and 1. 


e Ifthe class ofthe input image is uint8, the output image is a binary image 
of class uint8.The interpolated pixel values are rounded offto 0 and 1 so the 
output image can be of class uint8. 





Notfte For bicubic interpolation, you may need to damp doubles to within the 
[0 1] range. 





Ifyou use nearest neighbor interpolation, the result is always binary, because 
the values ofthe interpolated pixels are taken directly 位 om pixels in the input 
Image. 


Image Resizing 





Image Resizing 


To changethe size ofan image,usethe imresize function.Using imresize,you 
camni: 

e Specify the size ofthe output image. 

e Specify the interpolation method used 

e Specify the filter to use to prevent aliasing 


Specifying fthe Size of tfhe Outpuft Image 


Using imresize, you can Specify the size ofthe output image in two waysg 


e。 By specifying the magnification factor to be used on the image 
e By specifying the dimensions of the output image 


Using the Magnification Factor 

To enlarge an image, specify a magnification factor greater than 1. To reduce 
an image, specify a magnification factor between 0 and 1. For example, the 
command below increases the size of the image, I, by 1.25 times. 


II = imnread(' ic.tif' ); 
J = imresize(I,1.25) 
Imshow(I) 
figure，imshow(J) 
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Specifying fhe Size of the Output Image 


You can specify the size of the output image by passing a vector that contains 
the number of row and columns in the output image. The command below 
creates an output image, Y, with 100 rows and 150 columns. 


Y = imresize(X,[100 150]) 





Notfte Ifthe specified size does not produce the same aspect ratio as the input 
image, the output image will be distorted. 





Specifying the Interpolation Method 


By default, imresize uses nearest neighbor interpolation to determine the 
values of pixels in the output image but you can specify other interpolation 
methods. This table lists the supported interpolation methods. See 
“Interpolation” for more information about these methods. 








Argument Value Inferpolation Method 
'nearest， Nearest neighbor (the default) 
'bilinear' Bilinear interpolation 
'bicubic' Bicubic interpolation 





In this example, imresize uses the bilinear interpolation method. 


Y = imresize(X,[100 150]，bilinear ') 


Using Filters fo Prevent Aliasing 


Reducing the size of an image can introduce artifacts, such as aliasing, in the 
output image because information is always lost when youreduce the size of an 
image.Aliasing appears as ripple patterns (called Moire patterns) in the output 
Image. 


When you reduce the size of the image using either bilinear or bicubic 
interpolation, imresize automatically applies a low-pass filter to the image 


Image Resizing 





before interpolation, to limit the impact of aliasing on the output image. You 
can Specify the size ofthis filter or specify a different filter. 





Note 了 ven with low-pass fltering, resizing can introduce artifacts, because 
information is always lost when you reduce the size of an imasge. 





The imresize fuanction does not apply a low-pass filter 让 nearest neighbor 
interpolation is used. Nearest neighbor interpolation is primarily used for 
indexed images, and low-pass filtering is not appropriate for these images. 


You can also specify afilter of your own creation. For more information about 
specifying a filter, see the reference page for imresize. 
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To rotate an image, use the imrotate fuanction. imrotate accepts two primary 
arguments: 

e The image to be rotated 

e The rotation angle 

You specify the rotation angle in degrees. If you specify a positive value， 
imrotate rotates the image counterclockwise; 让 you specify a negative value， 


imrotate rotates the image clockwise. This example rotates the image, I, 35 
degrees in the counterclockwise direction . 


J= imnrotate(I,35) ; 
As optional arguments to imrotate, you can also specify: 


e The interpolation method 
e The size ofthe output image 


Specifying the Interpolation Method 


By default, imrotate uses nearest neighbor interpolation to determine the 
value of pixels in the output image but you can specify other interpolation 
methods. This table lists the supported interpolation methods. See 
“Interpolation” for more information about these methods. 








Argument Value Intferpolation Method 
'nearest， Nearest neighbor (the default) 
'bilinear' Bilinear interpolation 
'bicubic' Bicubic interpolation 





For example, these commands rotate an image 35"”counterclockwise and use 
bilinear interpolation. 

I= imread(' ic.tif' ); 

d imrotate(I,35，bilinear ) ; 

imshow(I) 

figure，imshow(Jy ) 


Image Rotation 








Specifying the Size of tfhe Outpuft Image 

By default, imrotate creates an output image large enough to include the 
entire original image. Pixels that fall outside the boundaries of the original 
image are setto 0 and appear as ablackbackground in the output image. Ifyou 
Specify the text string crop' as an argument, imrotate cropgs the output 
image to be the same size as the input image. (See the reference page for 
imrotate for an example of cropping.) 
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To extract a rectangular portion of an image, use the imcrop function. imcrop 
accepts two primary arguments: 


e The image to be cropped 

se The coordinates of a rectangle that defines the crop area 

H 节 youecall imcrop without specifying the crop rectangle, the cursor changes to 
a cross hair when it is over the image. Click on one corner of the region you 
want to select, and while holding down the mouse button, drag across the 


image. imcrop draws a rectangle around the area you are selecting. When you 
release the mouse button, imcrop creates anew image from the selected region. 


In this example, you display an image and call imcrop.Therectangle you select 
is shown in red. 


Imshow 工 c .七 车 
I= imcropi 


The imcrop fanction waits for you to dravw the cropping rectangle on the image. 





Image Cropping 





Now call imshow to display the cropped image. Ifyou call imcrop without 
specifying any output arguments, imcrop displays the image in a nevw figure. 


Imshow(I) 
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Performing General Spaftial Transformaftions 


To perform general 2-D spatial transformations, usethe imtransform function， 
(For information about performing more advanced transformations, see 
“Advanced Spatial Transformation Techniques”on page 4-15.) 


The imtransform fanction accepts two primary arguments: 


e The image to be transformed 


e Aspatial transformation structure, called a TFORM, that specifies the type of 
transformation you want to perform 


Specifying fthe Transformation Type 

You specify the type oftransformation you want to perform in a TFORM 
Structure. There are two ways to create a TFORM struct: 

e Using the maketform function 

e Using the cp2tform fanction 


Using maketform 

When you use the maketform function, you can sSpecify the type of 
transformation you want to perform. The following table lists the types of 
transformations maketform Supports. 





Transformaftion Descripfion 





'affine' Atransformation that may include translation， 
rotation, scaling, stretching and shearing. Straight 
lines remain straight, and parallel lines remain 
parallel, but rectangles may become parallelograms，. 


'projective' Atransformation in which straight lines remain 
straight, but parallel lines converge toward 
“vanishing points.”(The vanishing points may fall 
inside or outside the image 一 even at infinity.) 


'box' Aspecial case of an affine transformation where each 
dimension is shifted and scaled independently. 
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Transformation Descripfion 

Custom Auser-defined transformation, providing the forward 
and/or inverse functiongs that are called by 
imtransform. 

Composite A composition oftwo or more transformations. 





The 'custom' and 'composite' capabilities ofmaketform allovw a virtually 
limitless variety ofspatialtransformations to be used with imtransform and/or 
tformarray. 


Using cp2tform 

You use cp2tform to create the TFORM when you want to perform a 
transformation that requires fitting ofdqata points, such as a polynomial 
transformation. Chapter 5“Image Registration”explains how to use the 
cp2tform function to fit a 2-D transformation to a set of control points selected 
in apair of images. 





Nofte When used with imtransform, TFORM structures must define a 2-D 
spatial transformation. If an image contains more than two dimensions, Such 
as an RGB image, the same 2-D transformation is automatically applied to all 
2-D planes along the higher dimensions. For arbitrary-dimensional array 
transformations, use the tformarray function. 
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Performing fthe Transformaftion 


Once you define the transformation in a TFORM struct, you can perform the 
transformation by calling imtransform. 


For example, this code uses imtransform to perform a projective 
transformation of a checkerboard image. 


I = checkerboard(20,1，,1) ; 

figure; imshow(I) 

T = maketform( ' projective ，[1 1; 41 1; 41 41; 1 41]，,... 
[5 5; 40 5; 35 30j -10 30]) ; 

R = makereSsampJler(' cubic ，circular ' ) ; 

K = imtransform(I,T,R， Size' ,[100 100]，XYScale 1) ; 

figure，imshow(K) 


到 
0rigindl Transformed 
image image 


The imtransform fanction options let you control many aspects of the 
transformation. For example, note how the transformed image appears to 
contain multiple copies ofthe original image. This is accomplished by using the 
'Size' option,to maketheoutput imagelargerthantheinputimage,andthen 
specifying a padding method that extends the input image by repeating the 
pixels in a circular pattern. The Image Processing Toolbox Image 
Transformation demos provide more examples of using the imtransform 
fonction, and related functions, to perform different types of spatial 
transformations. 
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Advanced Spaftial Transformaftion Techniques 


The following fonctions, when used in combination, provide a vast arTray of 
optiongs for defining and working with 2-D, N-D, and mixed-D spatial 
transformations: 


e maketform 
efliptform 
etformfwd 

e tforminv 
efindbounds 

e makeresampJer 


etformarray 
e imtransform 


The imtransform, findbounds, and tformarray functions use the tformfwd 
and tforminv functiongs internally to encapsulate the forward transformations 
needed to determine the extent of an output image or array and/or to map the 
output pixels/array locations back to input locations. You can use tformfwd and 
tforminv to explore the geometric effects of atransformation by applying them 
to points and lines and plotting theresults. They support a consistent handling 
of both image and pointwise data. 


The previous example，“Performing the Transformation”on page 4-14, used 
the makeresampler function with a standard interpolation method. You can 
also useitto obtain special effects or custom processing.For example, you could 
specify your own separable filtering/interpolation kernel, build a custom 
resampler around the MATLAB interp2 or interp3 functions, or even 
implement an advanced anti-aliasing technique. 


And, as noted, you can use tformarray to work with arbitrary-dqimensional 
array transformations. The arrays do not even need to have the same 
dmensions. The output can either have a lower or higher number of 
dmensions than the input.， 


For example, 计 you are sampling 3-D data on a2-D slice or manifold, the input 
array might have alower dimensionality. The output dimensionality might be 
higher, for exzample, 过 you combine multiple 2-D transformationgs into a single 
2-D to 3-D operation. 
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This section describes the imasge registration capabilities ofthe Image Processing Toolbox. Image 
registration is the process of aligning two or more images ofthe same scene. Image registration ig 
often used as a preliminary step in other image processing applications. Topics covered include 


Terminology (p. 5-2) Provides definitions of image processing terms used in 
this section 

Registering an Image (p. 5-4) Steps you through an example of the image registration 
DrocesS 


Types of Supported Transformations Lists the types of supported transformationgs 
(p. 5-13) 


Selecting Control Points (p. 5-15) Describes how to use the Control Point Selection Tool 
(cpselect) to select control points in pairs of images 


Using Correlation to Improve Control “Describes how to use the cpcorr fanction to fine-tune 
Points (p. 5-33) your control point selections 
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An understanding ofthe following terms will help you to use this chapter. 





Terms 


MATLAB Definition 





Aligned image 


Base image 


Control point pairs 


Disfortion 


Global transformaftion 


Input image 


The output image after registration has been 
performed. The output image is derived by 
applying a transformation to the input 
image (see below) that brings it into 
alignment with the base image (see below). 


This is the image against which you compare 
the image to be registered. It js also often 
called the referemce image. 


Matching locations, also referred to asgs 
/apzad7marps, in the input image and the base 
image.， 


The differences in one image as compared to 
another ofthe same subject. These may have 
occurred as a result of terrain relief and 
other changes in perspective when imaging 
the same Scene ffom different viewpoints， 
lens and other internal sensor distortions, OF 
differences between sensors and Sensor 


types. 


Atransformation in which a single 
mathematical expression applies to an entire 
Image. 


This refers to the image that you wish to 
register. It is often called the opserveda image. 





Terminology 








Terms 


MATLAB Definition 





Local fransformafion 


Spaftial ftransformation 


Atransformation in which different 
mathematical expressions (usuajlly differing 
in parameters rather than form) apply to 
different regions within an image. 


The mapping oflocations ofpoints in one 
image to new locationgs in another image. 
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Image registration is the process of aligning two or more images of the same 
Scene. Typically, one image, called the base image, is considered the reference 
to which the other images, called input images, are compared. The object of 
image registration is to bring the input image into alignment with the base 
image by applying a spatial transformation to the input image. 


Aspatial transformation maps locationgs in one image to new locations in 
another image. (For more details, see Chapter 4 “Spatial Transformations.2”) 
Determining the parameters ofthe spatial transformation needed to bring the 
images into alignment is key to the image registration process， 


Image registration is often used as a preliminary step in other image 
processing applications. For example, you can use image registration to align 
satellite images ofthe earth's surface or images created by different medical 
diagnostic modalities (MRI and SPECT). After registration, you can compare 
features in the images to see how ariver has migrated, how an area is flooded， 
or to see ifatumor is visible in an MRI or SPECT imasge. 


Point Mapping 

The Image Processing Toolbox provides tools to Support point mapping to 
determine the parameters of the transformation required to bring an image 
into alignment with another image. In point mapping, you pick points in a pair 
of images that identify the same feature or ljandmark in the images. Then, a 
spatial mapping is inferred from the positions of these control points. 


Image registration using point mapping involves these stepgs: 
1 Read the images into the MATLAB workspace, 

2 Specify control point pairs in the images. 

3 Save the control point pairs. 


4 Fine tune the control points using cross-correlation. (This is an optional 
step.) 


5 Specify the type oftransformation to be used and infer its parameters from 
the control point pairs. 
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6 Transform the unregistered image to bring it into alignment， 


This process is best understood by looking at an example. See“Example: 
Registering to a Digital Orthophoto”on page 5-6 for an extended example. 





Note You may need to perform several iterationgs of this process， 
experimenting with different types of transformations, before you achieve a 
satisfactory result. In some cases, you may perform Successive registrations， 
removing gross global distortions first, and then removing smaller local 
distortions in subsequent passes. 





The following figure, Overview of Image Registration Process, provides a 
graphic illustration of this proceSss， 
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Figure 5-1: Overview of Image Registraftion Process 


Example: Registering to a Digital Orthophoto 

This example registers a digital aerial photograph to a digital orthophoto 
covering the same area. Both images are centered on the business district of 
West Concord, Massachusetts. 


The aerial image is geometrically uncorrected: it includes camera perspective， 
terrain and building relief and internal (lens) distortions, and it does not have 
any particular alignment or registration with respect to the earth. 


Registering an Image 





The orthophoto, supplied by the Massachusetts Geographic Information 
System (MassGIS), has been orthorectified to remove camera, perspective, and 
relief distortions (via a specialized imasge transformation process). It is also 
georegistered (and geocoded) 一 the columns and rows of the digital orthophoto 
image are aligned to the axes ofthe Massachusetts State Plane coordinate 
System, each pixel center corresponds to a definite geographic location, and 
every pixel is 1 meter square in map units, 


Step 1: Read the Images into MATLAB 

In this exzample, the base image is westconcordorthophoto.png, the MassGIS 
georegistered orthophoto. It is a panchromatic (grayscale) image. The imasge to 
be registered is westconcordaerial.png, a digital aerial photograph supplied 
by mPower3merge, and is a visible-color RGB imasge. 


orthophoto = imread(' westconcordorthophoto.png ) ; 
figure，imshow(orthophoto ) 

unregistered = imread(' westconcordaerial.png ) ; 
figure，imshow(unregistered ) 


You do not have to read the images into the MATLAB workspace. The 
cpselect fanction accepts file specificationgs for grayscale images. However, 让 
you want to Use cross-correlation to tune your control point positioning, the 
images must be in the workspace. 
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Aeria|l Photo Image Orihophoto Image 


Step 2: Choose Control Points in the Images 


The toolbox provides an interactive tool, called the Control Point Selection 
Tool, that you can use to pick pairs of corresponding control points in both 
images. Control points are landmarks that you can find in both images, like a 
road intersection, or a natural feature. 


To start this tool, enter cpselect at the MATLAB prompt, specifying as 
arguments the input and base imasges. 





Note The unregistered image is an RGB image. Because the Control Point 
Selection Tool only accepts grayscale images, the example passes only one 
plane of the color image to cpselect. 





cpselect (unregistered(:,: ,1),orthophoto) 


The cpselect fanction displays two views ofboth the input image and the base 
image in which you can pick control points by pointing and clicking. For more 


Registering an Image 





information, see“Selecting Control Points”on page 5-15. This figure shows the 


Control Point Selection Tool with four pairs of control points selected. The 


number of control point pairs you pick is at least partially determined by the 
type oftransformation you want to perform (specified in Step 5). See“Types of 
Supported Transformations”on page 5-13 for information about the minimum 
number of points required by each transformation 


Control Point Selection Tool 
File Edit View Help 
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Step 3: Save the Control Point Pairs to the MATLAB Workspace 


In the Control Point Selection Tool, click on the File menu and choose the Save 


Points to Workspace option. See“Saving Control Points”on page 5-30 for 


more information. 
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For example, the Control Point Selection Tool returns the following set of 
control points in the input image. These values represent spatial coordinates; 
the left column are x coordinates, the right column are y coordinates. 


Input_points = 
120.7086 93 .9772 
319 .2222 78 .9202 
127.9838 291.6312 
352.0729 281.1445 


Step 4: Fine-tune the Contro| Point Pair Placement 

This is an optional step that uses cross-correlation to adqjust the position ofthe 
control points you selected with cpselect. See“Using Correlation to Improve 
Control Points”on page 5-33 for more information. 





Notfte cpcorr can only adqjust points for images that are the same scale and 
have the same orientation. The images cannot be rotated relative to each 
other Because the Concord image is rotated in relation to the base image， 
cpcorr cannot tune the control points. When it cannot tune the points, cpcorr 
returns the input points, unmodified. 





input_points_corr = cpcorr(input_points,base_points,，... 
unregistered(:,，:),1),orthophoto ) 
input_points_corr = 
120.7086 93 .9772 
319 .2222 78 .9202 
127.1046 289.8935 
352.0729 281.1445 


Step 5: Specify the Type of Transformafion and Infer its Parameters 


In this step, you pass the control points to the cp2tform function that 
determines the parameters ofthe transformation needed to bring the image 
into alignment. cp2tform is a data-fitting function that determines the 
transformation based on the geometric relationship of the control points. 
cp2tform returns the parameters in a geometric transformation Structure， 
called a TFORM structure. 
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When you use cp2tform, youmust specify the type oftransformation you want 
to perform. The cp2tform fanction can infer the parameters for five types of 
transformations. You must choose which transformation will correct the type 
of distortion present in the input image. See“Types of Supported 
Transformations”on page 5-13 for more information. Images can contain more 
than one type of distortion. 


The predominant distortion in the aerial image of West Concord (the input 
image) results from the camera perspective. Ignoring terTrain relief which is 
minor in this area, image registration can correct for this using a projective 
transformation. The projective transformation also rotates the image into 
alignment with the map coordinate system underlying the base image (the 
digital orthophoto). Other distortions could be corrected Simultaneously by 
first creating a composite transformation with maketform, given sufficient 
information about the terrain and camera. (See“Performing General Spatial 
Transformations”on page 4-12 for more information.) 


mytform = cp2tform(input_points,base_points，projective ) 


Step 6: Transform the Unregistered Image 


As the final step in image registration, you transform the input image to bring 
it into alignment with the base image. You use imtransform to perform the 
transformation, passing it the input image and the TFORM structure, which 
defines the transformation. imtransform returns the transformed image. For 
more information about using imtransform, see Chapter 4 “Spatial 
Transformations.” 


registered = imtransform(unregistered ,mytform) 





Nofte The transformation defined in mytform, which is based on control 
points picked in only one plane ofthe RGB image, is applied to all three planes 
of the input image. 
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Compare the transformed image to the base image to see hovw the registration 
came out. 





Registered Image 
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Types of Supported Transformafions 


The cp2tform function can infer the parameters for Six types of 
transformations. This table lists the transformations in order of complexity， 
with examples of each type of distortion. 


The first four transformations，'1Linear conformal'，'affine',，'projective'， 
and 'polynomial' are global transformations. In these transformations, a 
single mathematical expression applies to an entire image. The last two 
transformations，'piecewise Linear' and '1Iwm' (local weighted mean), are 
local transformations. In these transformations, different mathematical 
expresslions apply to different regions within an image. 


When exploring how different transformationgs affect the images you are 
working with, try the global transformationgs first. Ifthese transformation are 
not satisfactory, try the local transformations; the piecewise linear 
transformation first and then the local weighted mean transformation. 





Transformation Type “Description Minimum Example 


Control Points 


'1inear conformal” Use this transformation when 2 pairs ] 有 


"affine， 


shapes in the input image are 
unchanged, but the image is 
distorted by some combination of 
translation, rotation, and scaling. 
Straight lines remain straight, and 
parallel lines are still parallel. 


Use this transformation when 3 pairs 

shapes in the input image exhibit 、 半 
shearing. Straight lines remain 中 本 
straight, and parallel lnes remain 

parallel, but rectangles become 

parallelograms. 
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"projective 


"polynomial- 


"piecewise 1Linear， 


“Wm 


Use this transformation when the 
Scene appears “tilted.”Straight 
lines remain straight, but parallel 
lines converge toward “vanishing 
points”(which may or may not fall 
within the image. 


Use this transformation when 
objects in the image are curved. The 
higher the order of the polynomial， 
the better the fit, but the result can 
contain more curves than the base 
image. 


Use this transformation when parts 
ofthe image appear distorted 
different]ly 


Use this transformation (local 
weighted mean), when the 
distortion Varies locally and 
piecewise linear is not sufficient. 


4 palrs 


6 palrs 
(order 2) 


10 palrs 
(order 3) 


16 palrs 
(order 4) 


4 palrs 


6 palrs 
(12 palrs 
recommended) 


mm、 泣 


唤 妇 


六 这 
次 滞 
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Selecfing Conftrol Points 


The toolbox includes an interactive tool that enables you to specify control 
points in the images you want to register. The tool displays the images 
slide-by-side. When you are satisfied with the number and placement ofthe 
control points, you can Save the control points. 


Using the Control Point Selecftion Tool 


To specify control points in a pair of images you want to register, use the 
Control Point Selection Tool, cpselect. The tool displays the image you want 
to register, called the zzpxt image, next to the image you want to compare it to， 
called the pase image or rejere7zce image. 


Specifying control points is a four-step process: 
1 Start the tool, specifying the input image and the base image. 


2 View the images, l]ooking for visual elements that you can identify in both 
images. cpselect provides many ways to navigate around the imasge， 
panning and zooming to view areags of the image in more detail. 


3 Specify matching control point pairs in the input image and the base image. 


4 Save the control points in the MATLAB workspace. 


Figure 5-2, Control Point Selection Tool shows the default appearance of the 
tool when you first start it. To get more information about any part of the 
interface, click on it in this figure. 
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Figure 5-2: Control Point Selection Tool 


Starting fhe Conftrol Poinf Selection Tool 

To use the Control Point Selection Tool, enter the cpselect command at the 
MATLAB prompt. As arguments, specify the image you want to register (the 
input image), and the image you want to compare it to (the base image). 


To illustrate, this code fagment reads an image into a variable, moon_base, in 
the MATLAB workspace. It then creates another version of the image with a 
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deliberate size distortion, called moon_input. This is the image that needs 
registration to remove the size distortion. The code then starts the cpselect 
tool, specifying the two images. 


moon_base = imread( ' moon.tif ) 
moon_input = imresize(moon base，1.2); 
cpselect(moon_input，moon_base) ; 


The cpselect command has other optional arguments. For example, you can 
restart a control point selection session by including a cpstruct Structure asg 
the third argument. For more information about restarting sessions, See 
“Saving Control Points”on page 5-30. For complete details, see the cpselect 
reference page. 


Default Views of the Images 


When the Control Point Selection Tool starts, it contains four image display 
windows. The top two windows are called the Detail windows. These windowsg 
show a closeup view of a portion ofthe images you are working with. The input 
image is on the left and the base image is on theright. The two windows at the 
bottom ofthe interface are called the Overview windows. These windows show 
the images in their entirety, atthejlargest scale that fits the window.Theinput 
overview image is on the left and the base overview image is on the right. 


Superimposed on the image in theOverview windowsgs is arectangle, called the 
Detail Rectangle. This rectangle defines the part ofthe image that is visible 
in the Detail window. By default, at startup, the Detail Rectangle covers one 
quarter ofthe entire image and is positioned over the center of the image. 
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Viewing the Images 

By default, cpselect displays the entire base and input images in the 
Overview windows and displays a close up view of a portion ofthese images in 
the Detail windows. However, to find visual elements that are common to both 
images,youmay wantto change the section ofthe image displayed in the detail 
View or zoom in on a part of the image to view it in more detail. The following 
sectiongs describe the different ways to change your view of the images. 
es“Using Scroll Bars to View Other Parts of an Image”on page 5-19 

e“Using the Detail Rectangle to Change the View”on page 5-19 

se“Moving the Image Displayed in the Detail Window”on page 5-19 
es“Zooming Imn and Out on an Image”on page 5-20 

es“Specifying the Magnification ofthe Images”on page 5-21 
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e“Locking the Relative Magnification ofthe Input and Base Images”on 
page 5-22 


Using Scroll Bars fo View Other Parts of an Image 
To view parts of an imasge that are not visible in the Detail or Overview 
windows, use the scroll bars provided in each window. 


As you scroll the image in the Detail window, note how the Detail Rectangle 
moves over the image in the Overview window. The position of the Detail 
Rectangle always shows the portion ofthe image in the Detail window. 


Using fthe Detail Rectangle fo Change the View 


To get a closer view ofany part ofthe image, move the Detail Rectangle in the 
Overview window over that section ofthe image. cpselect displays that 
section of the image in the Detail window at a higher magnification than the 
overview window. 


To move the Detail Rectangle: 
1 Click on the dqefault cursor button [ 虹 | in the button bar. 


2 Move the pointer into the Detail Rectangle. The cursor changes to the fleur 
shape， 人 中 ,indicating the directions in which it can be moved. 


3 Press and hold the mouse button to drag the Detail Rectangle anywhere on 
the imasge. 





Note As you move the Detail Rectangle over the image in the Overview 
window, the view of the image displayed in the Detail window changes. 





Moving the Image Displayed in the Detail| Window 


To change the section ofthe image displayed in the Detail window, use the 
了 and tool to move the image in the window. 


To use the Hand tool: 


1 Click on the Hand tool button | 蒜 人 | in the button bar. 
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2 Move the pointer over the image in the Detail window. The cursor changes 
shape， 休 ,indicating the directions in which it can be moved. 


3 Press and hold the mouse button and drag the image in the Detail window. 





Note As you move the image in the Detail windovw, the Detail Rectangle in 
the Overview window moves， 





Zooming In and Out on an Image 


To enlarge an image to get a closer look or shrink an image to see the whole 
image in context, use the Zoom buttons on the button bar. (You can also zoom 
in or out on an image by changing the magnification. See“Specifying the 
Magnification ofthe Images”on page 5-21 for more information.) 


To zoom in or zoom out on the base or input images: 


1 _ Click the appropriate “magnifying glass”button. 


Zoom in Zoom out 


| 友 到 下 


2 Move the pointer over the image you want to zoom in or out on. The cursor 
changes to the cross-hair cursor 十 . 


You can zoom in or out on either the input or the base images, in either the 
Detail or Overview windows. To keep the relative magnifications ofthe 
base and input images Synchronized, click the Lock ratio check box. See 
“Locking the Relative Magnification of the Input and Base Images”on 
page 5-22 for more information. 
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Note HIyou zoom in close on the image displayed in the Overview window， 
the Detail Rectangle may no longer be visible. 





You can use the zoom tool in two waysS: 


= Position the cursor over a location in the image and click the mouse. With 
each click, cpselect changes the magnification ofthe image by a preset 
amount. (See“Specifying the Magnification ofthe Images”on page 5-21for 
alist ofsome ofthese magnifications.) cpselect centers the new view of 
the image on the spot where you clicked. 


Alternately, you can position the cursor over a location in the image and， 
while pressing and holding the mouse button, draw a rectangle defining 
the area you want to zoom in or out on. cpselect magnifies the imasge so 
that the chosen section flls the Detail window. cpselect resizes the 
Detail Rectangle in the Overview window as wel]. 





Nofte When you zoom-in or -out on an image, notice how the magnification 
value changes. 





Specifying the Magnification of the Images 

To enlarge an image to get a closer look or to shrink an image to see the whole 
image in context, use the magnification edit box. (You can also use the Zoom 
buttons to enlarge or shrink an image. See “Zooming In and Out on an Image 
on page 5-20 for more information.) 


》 


To change the magnification of an image: 


1 Move the cursor into the magnification edit box of the window you want to 
change. The cursor changes to the text entry cursor. 





Note 了 ach Detail window and Overview window has its own magnification 
edit box. 
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2 Type anew value in the magnification edit box and press Enter, or click on 
the menu associated with the edit box and choose 他 om a list of preset 
magnifications. cpselect changes the magnification ofthe image and 
displays the new View in the appropriate window， 


Maognificofion menu 


闻 | 广 Lockratio 7% 了 | 
站 - 


Magnificafion edit box 
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Locking the Relative Magnification of the Inpuf and Base Images 

To keep the relative magnification ofthe input and base images automatically 
Synchronijzed in the Detail or Overview windows, click on the Lock Ratio 
checkbox. The two Detail windows and the two Overview windows each have 
their own Lock ratio checkboxes. 


When the Lock Ratio check box is selected, cpselect changes the 
magnification of po 胡 the input and base images when you zoom-in or -out on 
either one ofthe images or specify a magnification value for either ofthe 
images. 


Lock magnification rafio checkbox 





二- 
100% 了 | ZLockratio |63% 了 | 





Specifying Matching Control Point Pairs 


The primary function ofthe Control Point Selection Tool is to enable you to pick 
control points in the imasge to be registered, the input image, and the image to 
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which you are comparing it, the base image. When you start cpselect, the 
point selection tool is enabled, by default. 


You specify control points by pointing and clicking in the input and base 
images, in either the Detail or the Overview windows. Each point you specify 
in theinput imnagemusthaveamatch inthebase image.The following sectiongs 
describethe ways you can usethe Control Point Selection Tool to choose control 
point palrs: 


e“Picking Control Point Pairs Manually” 
se“Using Control Point Prediction”on page 5-25 


This section also describes how to move control points after youve created 
them and how to delete control points. 


Picking Control Point Pairs Manually 
To specify a pair of control points in your images: 


1 Click on the Control point selection button 写 |. Point selection mode is 
active by default. 


2 Position the cursor over a feature you have visually selected in any of the 
images displayed. The cursor changes to a pointing finger 


You can pick control points in either ofthe Detail windows, input or base, OF 
in either ofthe Overview windows, input or base. You also can work imn 
either direction: input-to-base image, or base-to-input image. 


3 _ Click the mouse button. cpselect places a control point symbol at the 
position you specified, in both the Detail window and the Overview window， 
(The appearance of the control point Symbol indicates its current state. 
Initially, control points are in an active, unmatched state. See“ControlPoint 
States”for more information ， 





Nofte Depending on where in the image you pick control points, the Symbol 
for the point may be visible in the Overview window, but not in the Detail 
window. 
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4 To create the match for this control point, move the cursor into the 
corresponding Detail or Overview window. (For example, 让 you started in 
an input window, move the cursor to a base window.) 


5 Click the mouse button. cpselect places a control point Symbol at the 
position you specified, in both the Detail and Overview windows. Because 
this control point completes a pair, the appearance ofthis symbol indicates 
an active, matched state. Note that the appearance ofthe first control point 
you Selected (in step 3) also changes to an active, matched state. 


You pick pairs of control points by moving 位 om a view of the input image to a 
View ofthe base image, or vice versa. You can pick several control points in one 
View of the image, and then move to the corresponding window to locate their 
matches. To match an unmatched control point, select it to make it active, and 
then pick a point in the corresponding view window. When you select a match 
for a control point, the symbols for both points changeto indicate their matched 
state. You can move or delete control points after you create them. 


The following figure illustrates control points in Several states. 
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Control Point Selection Tool 
File Edit wiew Help 


愉 | 昌 绅 镍 | 也 | 尽 | 沿 | 
Input Detail moon. 计 fs4% 桔 厂 Lock ratio [zs% | Base Detai 让 上 

















Active 
Unmatched 








Unmatched 








Matched 





























Using Control Point Prediction 

Instead of picking matching control points by moving the cursor between 
corresponding Detail or Overview windows, you can let the Control Point 
Selection Tool estimate the match for the control points you specify， 
automatically. The Control Point Selection Tool determines the position ofthe 
matching control point based on the geometric relationship of the previously 
selected control points. 
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Nofte By default, the Control Point Selection Tool does not include predicted 
points in the set ofvalid control points returned in input_points oF 
base_points. To include predicted points, you must accept them by selecting 
the points and fine-tuning their position with the cursor When you move a 
predicted point, the Control Point Selection Tool changes the symbol to 
indicate thatitphas changed to a standard control point. For more information， 
see“Moving Control Points”on page 5-28. 





To illustrate point prediction, this figure shows four control points selected in 
the input image, where the points form the four corners of a square. (The 
control points selections in the figure do not attempt to identify any landmarks 
in the image.) Thefigure showsthe picking ofafourth point, in the left window， 
and the corresponding predicted point in the right window. Note how the 
Control Point S$election Tool places the predicted point at the same location 
relative to the other control points, forming the bottom right corner of the 
Square. 








国 























Control point selected manuolly Predicdted conirol point 





Notfte Because the Control Point Selection Tool predicts control point 
locations based on the locationgs of the previous control points, you cannot use 
point prediction until you have a minimum oftwo pairs ofmatched points. 
Until this minimum is met, the point prediction button is disabled. 
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To use control point prediction: 
1 _ Click on the Control point prediction button| 绅 钨 |. 


2 Position the cursor anywhere in any ofthe images displayed. The cursor 
changes to a pointing finger 四 . 


You can pick control points in either ofthe Detail windows, input or base, OF 
in either ofthe Overview windows, input or base. You also can work in 
either direction: input-to-base image or base-to-input image. 


3 Click either mouse button. The Control Point Selection Tool places a control 
point symbol at the position you specified and places another control point 
Symbol for a matching point in all the other windows. The symbol for the 
predicted point contains the letter “P”, indicatingthatit's a predicted control 
point. 


This figure illustrates predicted points in active unmatched, matched, and 
predicted states. For a complete description of all point states, see“Control 
Point States”on page 5-27. 
































Predicted control Active predicted 
point Coniro|l point 


Contro|l Point States 


The appearance of control point symbols indicate their current state. When you 
first pick a control point, its state is active and unmatched. When you pick the 
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match for a control point, the appearance of both symbols changes to indicate 
their matched status. 


This table lists all the possible control point states with their symbols. 
cpselect displays this list in a separate window called a Legendq. The Legend 
is visible by default, but you can control it's visibility using the Legend option 
位 om the View menu. 


Table 5-1: Control Point States 





Symbol State Descripfion 





国 Active unmatched The point is currently selected but does 
not have amatching point. This is the 
initial state of most points. 


转 Active matched The point is currently selected and has a 
matching point. 


较 Active predicted The point is a predicted point. If you 
move its position, the point changes to 
active matched state. 


十 Unmatched The point is not selected and it is 
unmatched. You must select it before you 
can create its matching point. 


Matched The point has a matching point. 


Predicted This point was added by cpselect 
during point prediction. 





Moving Contro| Points 
To move a control point 


1 Click on the Control point selection button 上旬 | orthe default cursor button 
荐 到 


2 Position the cursor over the control point you want to move. 





3 Press and hold the mouse button and drag the control point. The state ofthe 
control point changes to active when you click on 让 . 
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If you move a predicted control point, the state of the control point changes to 
aregular (nonpredicted) control point. 


Delefting Control Points 
To delete a control point, and optionally its matching point: 


1 Cjlick on the Control point selection button “从 | orthe default cursor button 


硬 到 
2 Click on the control point you want to delete. Its state changes to active. 下 
the control point has a match, both points become active. 





3 Delete the point (or points) using one of these methods: 
= Pressing the Backspace key 
= Pressing the Delete key 
= Choosing one of the delete options from the 了 Edit mennu， 


Using this menu you can delete individual points or pairs of matched 
points, in the input or base images. 


Undo Delete 
Redo Delete 
[一 Delete Active Pair 
Delete 0ptiions ”一 一 Delete Active Input Point 
Delete Active Base Point 








Undoing and Redoing Contro|l Point Selections 
You can undo a deletion or series of deletiongs using the Undqdo Delete option on 
the cpselect 了 dit menu， 


Undo opiiong 人 ee 
p [E Redo Delete 





Delete Active Pair 
Delete Active Input Point 
Delete Active Base Point 





After undoing a deletion, you can delete the points again using the Redo 
option, also on the 了 qit menu. 
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Saving Control Points 


After you specify control point pairs, you must save them in the MATLAB 
workspace to make them available for the next step in image registration， 
processing by cp2tform. 


To save control points to the MATLAB workspace: 
1 _ Select File on the Control Point Selection Tool menu bar. 


2 _ Choose the Save Points to Workspace option. The Control Point Selection 
Tool displays this qialog box: 


Save Points to Workspace Lx| 


[v Imputpoints ofvalidpairs input_points 
[Jv 6asepoints ofvalid paifrs: jbase_points 
六 Structure with all points: jpstruct 


OK | Cancel | 








By default, the Control Point Selection Tool saves thex andy coordinates that 
specify the locationgs of the control points you selected in two arrays named 
input_points and base_points, although you can specify other names. These 
are 7-by-2 arrays, where 7 is the number ofvalid control point pairs you 
selected. For example, this is an example ofthe input_ points array 让 you 
picked four pairs of control points. The values in the left column represent the 
X coordinates; the values in the right column represent the y coordinates. 


input_points = 


215.6667 262.3333 
225.7778 311.3333 
156.5556 340.1111 
270.8889 368.8889 


Whenever you exit the Control Point Selection Tool, it asks 让 you want to Save 
your control points. 
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Saving Your Contro| Point Selecfion Session 


To save the current state ofthe Control Point Selection Tool, select the 
Structure with all points check box in the Save Points to Workspace dialog 
box. 


Save Points to Workspace Lx| 


JI” Input points ofvalid pairs: Jnput_points 
J” Base points ofvalid pairs: jpase_points 
呈 [pstruct 


Cancel | 
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This option saves the position of all the control points you specified and their 
current state in a cpstruct Structure, 


cpstruct = 


inputPoints: [4x2 double] 
basePoints: [4x2 doubjle] 
inputBasePairs: [4x2 double] 
ids: [4x1 double] 
inputIdPairs: [4x2 double] 
baseIdPairs: [4x2 double] 
1iSInputPredicted: [4x1 doub1le] 
1ISBasePredicted: [4x1 double] 


You can use the cpstruct to restart a control point selection session at the 
point where you left of 


This option is usefu] 计 you are picking many points over a long time and want 
to preserve unmatched and predicted points when you resume work. The 
Control Point Selection Tool does not include unmatched and predicted points 
in the input_points and base_points arTrays. 


To extract the arrays of valid control point coordinates 位 om a cpstruct, use 
the cpstruct2pairs function. 


5-32 


Using Correlation to Improve Contro|l Points 





Using Correlation to Improve Control Points 


You may want to fine-tune the control points you selected using cpselect. 
Points selected by eye using the interactive tool can sometimes be improved 
using cross-correlation. 


To use cross-correlation, pass sets of control points in the input and base 
images, along with the images themselves, to the cpcorr function 


input_pts_adj= cpcorr(input_points，base_points，input，base) ; 


The cpcorr function defines 11-by-11l regiongs around each control point in the 
input image and around the matching control point in the base image, and then 
calculates the correlation between the values at each pixel in the region. Next， 
the cpcorr function looks for the position with the highest correlation value 
and uses this as the optimal position ofthe control point. The cpcorr function 
only moves control points up to 4 pixels based on the results of the crosg 
Correlation , 





Nofte Features in the two imnages must be atthe same scale and have the 
same orientation. They cannot be rotated relative to each other 





If cpcorr cannot correlate some of the control points, it returns their values in 
input_points, unmodified. 
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Neighborhood and Block 
Operatlons 





This section discusses these generic block processing functions. Topics covered include 


Terminology (p. 6-2) Provides definitions of image processing terms used in 
this section 

Block Processing Operations (p. 6-3) Provides an overview of the types of block processing 
operations Supported by the toolbox 

Sliding Neighborhood Operationgs Defines sliding neighborhood operationgs and describes 

(p. 6-5) how you can use them to implement many types of 
在 ltering operationgs 

Distinct Block Operations (p. 6-9) Describes block operations 

Column Processing (p. 6-12) Describes hovw to process sliding neighborhoods or 


distinct blocks as columns 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


Definitions 





Block operaftion 


Border padding 


Center Pixel 


Column processing 


Distinct block operaftion 


Neighborhood operation 


Overlap 


An operation in which an image is processed in 
blocks rather than all at once. The blocks have 
the same Size acrogsgs the image. Some operation 
is applied to one block at a time. The blocks are 
reassembled to form an output image，. 


Additional rows and columns temporarily 
added to the border(s) of an image when some 
of the blocks extend outside the image. The 
additional rows and columns normally contain 
Zer0S， 


The pixel at the center of a neighborhood. 


An operation in which neighborhoods are 
reshaped into colummns before processing in 
order to speed up computation time. 


Ablock operation in which the blocks do not 
overlap. 


An operation in which each output pixel is 
computed 人 fom a set of neighboring input 
pixels. Convolution, dilation, and median 

和 ltering are examples ofneighborhood 
operations. A neighborhood operation can also 
be called a sliding neighborhood operation 


也 xtra rowgs and columns of pixels outside a 
block whose values are taken into account 
when processing the block. These extra pixels 
cause distinct blocks to overlap one another. 
The blkproc function enables you to specify an 
overlap. 
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Block Processing Operations 


Certain image processing operations involve processing an image in Sectiongs 
called blocps, rather than processing the entire image at once. 


The Image Processing Toolbox provides several functiongs for specific 
operations that work with blocks, for example,the imdqilate fanction forimage 
dilation. In addition, the toolbox provides more generic functions for processing 
an image in blocks. This chapter discusses these generic block processing 
fonctions， 


To use one ofthe functions, you Supply information about the size ofthe blocks， 
and specify a separate function to use to process the blocks. The block 
processing function does the work of breaking the input image into blocks， 
calling the specified fonction for each block, and reassembling the results into 
an output image. 


Types of Block Processing Operations 


Using these functions, you can perform various block processing operations， 
including sLiqQzmg mezSsApborooa operatiozs and ais 万 7ct DLocR opera 碟 o728， 


e。 JIn asgsliding neighborhood operation, the input image is processed in a 
pixelwise fashion. That is, for each pixel in the input image, some operation 
is performed to determine the value ofthe corresponding pixel in the output 
image. The operation is based on the values of a block of neighboring pixels. 


e In adistinct block operation, the input image is processed a block at a time， 
That is, the image is divided into rectangular blocks, and some operation is 
performed on each block individually to determine the values of the pixels in 
the corresponding block of the output image. 


In adqdqition, the toolbox provides fuanctions for colx7z7 processI712S operato1.8. 
These operations are not actually distinct 们 om block operations; instead, they 
are a way of speeding up block operationgs by rearranging blocks into matrix 
columns. 


Note that even 让 you do not use these block processing functions, the 
information here may be useful to you, as it includes concepts fundamental to 
many areas of image processing. In particular, the discussion of sliding 
neighborhood operations is applicable to linear filtering and morphological 
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operations. See Chapter 7 “Linear Filtering and Filter Design”and Chapter 9， 
“Morphological Operations”for information about these applications. 


Sliding Neighborhood Operations 





Sliding Neighborhood Operaftions 


Asgsliding neighborhood operation is an operation that is performed a pixel at a 
time, with the value of any given pixel in the output image being determined 
by applying some algorithm to the values of the corresponding input pixels 
7elS57po7rAooa. A pixels neighborhood is some set of pixels, defined by their 
locationgs relative to that pixel, which is called the cezter pixeL. The 
Deighborhood is a rectangular block, and as you move from one element to the 
next in an image matrix, the neighborhood block slides in the same direction. 


The following figure shows the neighborhood blocks for some ofthe elements in 
a 6-by-5 matrix with 2-by-3 sliding blocks. The center pixel for each 
neighborhood is marked with a dot.， 


国 品 吕 
十 二 


E 


Figure 6-1: Neighborhood Blocks in a 6-by-5 Matrix 


The center pixel is the actual pixel in the input image being processed by the 
operation. Ifthe neighborhood has an odd number ofrows and columns, the 
center pixel is actually in the center of the neighborhood. Ifone ofthe 
dmensions has even length, the center pixel is just to the left of center or just 
above center. For example, in a 2-by-2 neighborhood, the center pixel is the 
upper left one, 


For any m-by-n neighborhood, the center pixel is 


floor(([m nl+1)/2) 


In the 2-by-3 block shown in Figure 6-1, the center pixel is (1,2), or, the pixel in 
the second column of the top row ofthe neighborhood. 
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To perform a sliding neighborhood operation: 
1 _ Select a single pixel. 
2 Determine the pixels neighborhood. 


3 Apply a fonction to the values of the pixels in the neighborhood. This 
fanction must return a scalar. 


4 Find the pixel in the output image whose position corresponds to that ofthe 
center pixel in the input image. Set this output pixel to the value returned 
by the fanction. 


5 Repeat steps 1 through 4 for each pixel in the input imasge. 


For example, sSuppose Figure 6-1 represents an averaging operation. The 
fonction might sum the values ofthe six neighborhood pixels and then divide 
by 6. The result is the value of the output pixel. 


Padding Borders 


As Figure 6-1 shows, some of the pixels in a neighborhood may be missing， 
especially ifthe center pixel is on the border ofthe image. Notice that in the 
fgure, the upper left and bottom right neighborhoods include “pixels” that are 
not part ofthe image. 


To process these neighborhoods, sliding neighborhood operations paa the 
borders ofthe image, usually with 0?s. In other words, these fanctions process 
the border pixels by assuming thatthe image is surrounded by additional rows 
and columns of 0's. These rows and columns do not become part of the output 
image and are used only as parts of the neighborhoods of the actual pixels in 
the imasge. 


Linear and Nonlinear Filtering 


You can use sliding neighborhood operations to implement many kinds of 
fltering operations. One example of a sliding neighbor operation is 
convolution, which is used to implement linear filtering. MATLAB provides the 
conv and filter2 functions for performing convolution, and the toolbox 
provides the imfilter function. See Chapter 7，“Linear Filtering and Filter 
Design” for more information about these functions， 
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In adqdition to convolution, there are many other filtering operations you can 
imnplement through sliding neighborhoods. Many of these operations are 
nonlinear in nature. For example, you can Implement a sliding neighborhood 
operation where the value of an output pixel is equal to the standard deviation 
of the values of the pixels in the input pixels neighborhood. 


You can use the nlLfilter function to imnplement a variety of sliding 
neighborhood operations. nLfilter takes as input arguments an image, a 
neighborhood size, and a function that returns a scalar, and returns an image 
ofthe same size as the input image. The value ofeach pixel in the output image 
is computed by passing the corresponding input pixels neighborhood to the 
fanction. For example, this call computes each output pixel by taking the 
standard deviation ofthe values ofthe input pixels 3-by-3 neighborhood (that 
is, the pixel itself and its eight contiguous neighbors). 


I2 = nlfilter(I,[3 3]，std2 ) ; 


You can write an M-file to imnplement a specific function, and then use this 
fanction with nLfilter.or example, this command processes the matrix I in 
2-by-3 neighborhoods with a function called myfun .m. 


nlLfilter(I,[2 3],emyfun) ; 


emyfun is an example of a function handle. You can also use an inline fanction. 
For example， 


f= inline(' sqrt(min(x(:))) ); 
I2 = nlfilter(I,[2 2],f); 


The example below uses nlLfilter to set each pixel to the maximum value in 
its 3-by-3 neighborhood. 


II = imread( tire.tif ' ) ; 
f= inline('max(x(:)) ); 
I2 = nlfilter(I,[3 3],f) ; 
Imshow( 工 ) ; 
figure，imshow(I2) ; 
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Figure 6-2: Each Output Pixel Setf fo Maximum Inputf Neighborhood Value 


Many operationgs that nlfilter can imnplement run much faster 计 the 
computations are performed on matrix columns rather than rectangular 
neighborhoods. For information about this approach, see the reference page for 
COJlLfilt. 





Nofte nlfilter is an example of a“function function.”For more information 
on how to use this kind of function, see Eunction Functions in the MATLAB 
documentation. For more information on inline functions, see inline in the 
MATLAB Function Reference. For more information on function handles, see 
fanction_ handle in the MATLAB Function Reference. 
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Disftinct Block Operaftions 


Distipzct biocps are rectangular partitions that divide a matrix into m-by-n 
sections. Distinct blocks overlay the image matrix starting in the upper-le 化 
corner,， with no overlap. Ifthe blocks don't fit exactly over the image, the 
toolbox adds zero padding so that they do. Figure 6-3 shows a 15-by-30 matrix 
divided into 4-by-8 blocks. 
































Figure 6-3: An Image Divided into Disftinct Blocks 
The zero padding process adds 0?"s to the bottom and right ofthe image matrix， 
as needed. After zero padding, the matrix is size 16-by-32. 


The function blkproc performs distinct block operations. blkproc extracts 
each distinct block 位 om an image and passes it to a fanction you specify. 
blkproc assembles the returned blocks to create an output imasge. 


For example, the command below processes the matrix I in 4-by-6 blocks with 
the function myfun. 


I2 = blkproc(I,[4 6],emyfun) ; 
You can specify the function as an inline function. For example， 


f= inline('mean2(X)*oneSs(Size(Xx)) ); 
I2 = blkproc(I,[4 6],f); 


O Neighporhood and Block Operations 





6-10 


The example below uses blkproc to set every pixel in each 8-by-8 block of an 
image matrix to the average of the elements in that block. 


I= imread('tire.tif ); 

f= inline('uint8(round(mean2(x)*ones(Size(x)))) ); 
I2 = blkproc(I,[8 8],f); 

imshow(I) 

figure，imshow(I2) ; 





Notice that inLline computes the mean ofthe block and then multiplies the 
resultbyamatrix ofones, sothatthe outputblock is the same size as the input 
block. As a result, the output image is the same size as the input image. 
blkproc does not require that the images be the same size; however, 让 this is 
the result youwant, youmust make sure that the fonction you specify returns 
blocks of the appropriate size. 





Notfte blkproc is an example of a“function function.”For more information 
on hovw to use this kind of function, see the Function Functions section in the 
MATLAB documentation. 





Overlap 

When youcall blkproc to define distinct blocks, you can specify that the blocks 
overlap each other, that is, you can specify extra rows and columns of pixels 
outside the block whose values are taken into account when processing the 
block. When there is an overlap, blkproc passegs the exzpanded block (including 
the overlap) to the specified fuanction. 
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Figure 6-4 shows the overlap areas for some of the blocks in a 15-by-30 matrix 
with 1-by-2 overlaps. 了 ach 4-by-8 block has a one-row overlap above and below， 
and a two-column overlap on each side. In the figure, shading indicates the 
overlap. The 4-by-8 blocks overlay the image matrix starting in the upper-le 化 
corner， 












































Figure 6-4: An Image Divided into Distinct Blocks With Specified Overlaps 


To specify the overlap, you provide an additional input argument to blLkproc. 
To process the blocks in the fgure above with the function myfun, the call is 


B = blkproc(A,[4 8],[1 2],emyfun) 


Overlap often increases the amount of zero padding needed. For example, in 
Figure 6-3, the original 15-by-30 matrix became a 16-by-32 matrix with zero 
padding. When the 15-by-30 matrix includes a 1-by-2 overlap, the padded 
matrix becomes an 18-by-36 matrix. The outermost rectangle in the figure 
delineates the new boundaries ofthe imasge after padding has been added to 
accommodate the overlap plus block processing.Noticethatin thefigure above， 
padding has been added to the left and top ofthe original image, notjustto the 
Tight and bottom. 
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Column Processing 


The toolbox provides functions that you can use to process sliding 
neighborhoods or distinct blocks as columns. This approach is useful for 
operations that MATLAB performs columnwise; in many cases, column 
processing can reduce the execution time required to process an image， 


For example, suppose the operation you are performing involves computing the 
mean of each block. This computation is much faster 让 you first rearTrange the 
blocks into columns, because you can compute the mean of every column with 
a single call to the mean function, rather than calling mean for each block 
individually. 


You can use the colfilt function to imnplement column processing. This 
fonction: 


1 Reshapes each sliding or distinct block of an image matrix into a column in 
a temporary matrixX 


2 Passes the temporary matrix to a function you specify 


3 Rearranges the resulting matrix back into the original shape 


Sliding Neighborhoods 


For aslidingneighborhood operation, coLIfilt creates atemporary matrix that 
has a separate column for each pixel in the original image. The column 
corresponding to a given pixel contains the values ofthat pixels neighborhood 
位 om the original image. 


Figure 6-5 illustrates this process. In this figure, a 6-by-5 image matrix is 
processed in 2-by-3 neighborhoodqds. coLIfilt creates one column for each pixel 
in the image, so there are a total of 30 columns in the temporary matrix. 也 ach 
pixels column contains the value ofthe pixels in its neighborhood, so there are 
SiX TOwWS. COLfilt zero pads the input image as necesSary. For example, the 
neighborhood of the upper left pixel in the figure has two zero-valued 
neighbors, due to zero padding. 


Column Processing 





Figure 6-5: colfilt Creates a Temporary Matrix for Sliding Neighborhood 


The temporary matrix is passedto a function, which mustreturn a single value 
for each column. (Many MATLAB fanctions work this way, for example, mean， 
median, std, sum, etc.) The resulting values are then assigned to the 
appropriate pixels in the output image. 


colfiltcan produce the same results as nLIfilter with faster execution time; 
however, it may use more memory. The example below sets each output pixel 
to the maximum value in the input pixels neighborhood, producing the same 
result as the nlLfilter example shown in Figure 6-2. 


I2 = colfilt(I,[3 3]，sliding ,emax ) ; 


Disfincf Blocks 


For a distinct block operation, colfilt creates a temporary matrix by 
rearranging each block in the image into a column. colLfilt pads the original 
image with 0's, ifnecessary, before creating the temporary matrix. 


Figure 6-6 illustrates this process. In this fgure, a 6-by-16 image matrix is 
processed in 4-by-6 blocks. colfilt first zero pads the image to make the size 
8-by-18 (six 4-by-6 blocks), and then rearranges the blocks into 6 columns of 24 
elements each. 
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Figure 6-6: colfilt Creates a Temporary Matrix for Distinct Block Operation 


After rearranging the image into a temporary matrix, coLIfilt passes thigs 
matrix to the fanction. The function must return a matrix ofthe same Size as 
the temporary matrix. Ifthe block size is m-by-n, and the image is mm-by-nn, the 
size ofthe temporary matrix is (mxn)-by-(ceil(mm/m)*ceil(nn/n)). After the 
fonction processes the temporary matrix, the output is rearranged back into 
the shape ofthe original image matrix， 


This example sets all the pixels in each 8-by-8 block of an image to the mean 
pixel value for the block, producing the same result as the blkproc example in 
“Distinct Block Operations”on page 6-9. 


Column Processing 





II = imn2double(imread( tire.tif ' ) ) 

f= inline(' ones(64,1)*mean(x) ); 

I2 = Colfilt(I,[8 8]，distinct ,f) ; 
Notice that the inline function computes the mean of the block and then 
multiplies the result by a vector of ones, so that the output block is the same 


size as the input block. As a result, the output image is the same size as the 
input Image. 


Restrictions 


You can use co1filt to imnplement many ofthe same distinct block operationgs 
that blkproc performs. However, coL1filt has certain restrictions that 
bl1kproc does not: 


e The output image must be the same size as the input image. 
e The blocks cannot overlap. 


For Situations that do not satisfy these constraints, use blLkproc， 
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Linear 了 iltering and Filter 
Deslpgn 





The Image Processing Toolbox provides anumber of functiongs for designing and implementing 
two-dimensional linear filters for image data. This section qdqescribes these functions and how to use 
them effectively Topics covered include 


Terminology (p. 7-2) Provides definitions of image processing terms used in 
this section 


Linear Filtering (p. 7-4) Provides an explanation oflinear filtering and how t is 
implemented in the toolbox. This topic describes filtering 
in terms ofthe spatial domain, and is accessible to 
anyone doing image processing. 


Filter Design (p. 7-16) Discusses designing two-dimensional finite imnpulse 
response (了 IRJ) 有 lters. This section assumes you are 
familiar with working in the frequency domain. 
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Terminology 


An understanding ofthe following terms will help youto use this chapter. Note 
that this table includes brief definitions ofterms related to filter design; a 
detailed discussion ofthese terms and the theory behind filter design is outside 
the scope of this User's Guide. 





Terms Definitions 





Convoluftion Aneighborhood operation in which each output pixel is a weighted 
sum of neighboring input pixels. The weights are defined by the 
convolution kernel. Image processing operations implemented with 
convolution include smoothing, sharpening, and edge enhancement. 


Convolution kernel Amatrix of weights used to perform convolution. A convolution 
kernel is a correlation kernel that has been rotated 180 degrees. 


Correlaftion Aneighborhood operation in which each output pixel is a weighted 
sum of neighboring input pixels. The weights are defined by the 
correlation kernel. Correlation is closely related mathematically to 
convolution. 


Correlaftion kernel Amatrix of weights used to perform correlation. The flter design 
functions in the Image Processing Toolbox return correlation 
kernels. A_ correlation kernel is a convolution kernel that has been 
rotated 180 degrees. 


FIR filter Atfilter whose response to a single point, or imnpulse, has finite 
extent. 了 FIR stands for finite imnpulse response. An FIR filter can be 
imnplemented using convolution. All filter design functions in the 
Image Processing Toolbox return FIR flters， 


Frequency response Amathematical function describing the gain of a filter in response 
to different input 他 equencies. 


Neighborhood operation ”An operation in which each output pixel is computed from a set of 
neighboring input pixels. Convolution, dilation, and median 
和 ltering are examples of neighborhood operations， 





Terminology 








Terms 


Definitions 





Ripples 


Window metihod 


Oscillations around a constant value. The frequency response of a 
practical filter often has ripples where the frequency response of an 
ideal filter is flat. 


Atfilter design method that multiples the ideal impulse response by 
a windovw function, which tapers the ideal impulse response. The 
resulting filter's 他 equency response approximates a desired 

位 equency response. 
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Linear Filtering 


Filtering is a technique for modifying orenhancing an image.For example, you 
can filter an image to emphasize certain features or remove other features. 


Filtering is a ez 有 porjpooa operatiom in which the value of any given pixel in 
the output image is determined by applying some algorithm to the values ofthe 
pixels in the neighborhood ofthe corresponding input pixel. A_ pixels 
neighborhood is some set of pixels, defined by their locations relative to that 
pixel. (See Chapter 6,“Neighborhood and Block Operations”, for a general 
discussion ofneighborhood operations.) 


Zea7 万 /te7z72s is fltering in which the value of an output pixel is a linear 
combination of the values of the pixels in the input pixels neighborhood. 


This section discusses linear filtering in MATLAB and the Image Processing 
Toolbox. It includes: 

e。 A description offiltering, using convolution and correlation 

e A description ofhow to use the imfilter function to perform 帮 ltering 

e Adiscussion about using predefined filter types 


See “Filter Design”on page 7-16 for information about hovw to design filters. 


Convolufion 


Linear filtering of an image is accomplished through an operation called 
co7VOLto. In convolution, the value of an output pixel is computed as a 
weighted sum of neighboring pixels. The matrix of weights is called the 
CO10OLLto7 Rer7le1, also known as the 广 /ter. 


For example, sSuppose the image is 


A= [17 24 1 8 15 
23 5 7 14 16 
4 6 13 20 22 
10 12 19 21 3 
11 18 25 2 9] 


and the convolution kernel is 
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Then Figure 7-1 shows hovw to compute the (2,4) output pixel using these steps: 
1 Rotate the convolution kernel 180 degrees about its center element. 


2 Slide the center element of the convolution kernel so that lies on top ofthe 
(2,4) element of A. 


3 Multiply each weight in the rotated convolution kernel by the pixel of A 
underneath. 


4 Sum up the individual products fom step 3. 


Hence the (2,4) output pixel is 
1.2+8.:.9+15.4+7:7+14.5+16.3+13.6+20.1+22.8=575 


Values of rotated convolufion kernel 
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Figure 7-1: Computing the (2,4) Output of Convolution 
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Correlafion 


The operation called correlatio7 is closelyrelated to convolution. In correlation， 
the value ofan output pixel is also computed as a weighted sum of neighboring 
pixels. The difference is that the matrix of weights, in this case called the 
co17Telatiom per7lel, is notrotated during the computation.Figure 7-2 shows how 
to compute the (2,4) output pixel ofthe correlation of A, assuming h is 
correlation kernel instead of a convolution kernel, using these steps: 


1 Slide the center element ofthe correlation kernel so that lies on top ofthe 
(2,4) element of A. 


2 Multiply each weight in the correlation kernel by the pixel of A underneath. 


3 Sum up the individual products 位 om step 3. 


The (2,4) output pixel 他 om the correlation ig 


1.8+8.1+15.6+7.3+14.5+16.7+13.4+20.9+22.2=585 


Values of correlotion kernel 
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Figure 7-2: Compufting the (2,4) Output of Correlation 
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Filtering Using imfilfer 

Filtering of imnages, either by correlation or convolution, can be performed 
using the toolbox function imfilter. This example filters the image in the file 
blood1.tif with a 5-by-5 filter containing equal weights. Such a filter is often 
called an averagzi7s 万 !ter. 


I= imnread(' blood1.tif ) ; 

h = ones(5,5) / 25; 

I2 = imfilter(I,h); 
imshow(I)，title('original image ') 
figure，imshow(I2)，title('Filtered image ') 





0riginal Image Filtered Image 


Data Types 

The imfilter fanction handles data types similar to the way the image 
arithmetic fanctions do, as described in“Image Arithmetic Truncation Rules?” 
on page 2-22. The output image has the same data type, or numeric class,agS 
the input image. The imfilter function computes the value ofeach output 
pixel using double-precision, floating-point arithmetic. Ifthe result exceeds the 
range ofthe data type, the imfilter function truncates the result to that data 
type's allowed range. Ifit is an integer data type, imfilter rounds factional 
Values. 


Because of the truncation behavior, you may sometimes want to consider 
converting your image to a different data type before calling imfilter. In this 
example,the output of imfilter has negative values when the input is of class 
doub1e. 
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A = magic(5) 

一 
17 24 1 8 15 
23 5 7 14 16 
4 6 13 20 22 
10 12 19 21 3 
11 18 25 2 9 

h= [-101] 

h 一 
-1 0 1 


ImfIlter(A;h) 


ans = 
24 -16 -16 14 -8 
5 -16 9 9 -14 
6 9 14 9 -20 
12 9 9 -16 -21 
18 14 -16 -16 -2 


Notice that the result has negative values. Now suppose A was of class uint8， 
instead of doub1e. 

A = uUint8(magic(5) ); 

imfilter(Ayh) 


ans = 
24 0 0 14 0 
5 0 9 9 0 
6 9 14 9 0 
12 9 9 0 0 
18 14 0 0 0 


Since the inputto imfilteris ofclass uint8, the output also is ofclass uint8， 
and so the negative values are truncated to 0. In such cases, it may be 
appropriate to convert the image to another type, such as a signed integer type， 
single, or double, before calling imfilter. 
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Correlation and Convolufion Options 


The imfilter fanction can perform filtering using either correlation or 
convolution. It uses correlation by default, because the filter qdqesign functions， 
described in "Filter Design”on page 7-16, and the fspecial function, described 
in “Using Predefined Filter Types”on page 7-14, produce correlation kernels. 


However, 让 you want to perform filtering using convolution instead, you can 
pass the string 'conv' as optional input argument to imfilter. For example， 


A = magic(5); 
h= [-101] 
ImfIlter(A,h) %5 filter USing correlation 


ans = 
24 -16 -16 14 -8 
5 -16 9 9 -14 
6 9 14 9 -20 
12 9 9 -16 -21 
18 14 -16 -16 -2 


ImfIlter(A,h，conv ) s%5 filter USing convolution 


ans = 
-24 16 16 -14 8 
-5 16 -9 -9 14 
-6 -9 -14 -9 20 
-12 -9 -9 16 21 
-18 -14 16 16 2 
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Boundary Padding Options 

When computing an output pixel at the boundary of an image, a portion ofthe 
convolution or correlation kernel is usually off the edge of the image, as 
illustrated in the figure below. 


What value should ihese 
outside pixels hove? 
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Figure 7-3: When the Values of the Kernel Fall Outside the Image 


The imfilter function normally flls in these“off-the-edge”image pixels by 
assuming that they are 0. This is called zero-padding and is illustrated in the 
和 gure below. 
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0utside pixels ore 
assumed to be 0. 
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Figure 7-4: Zero-Padding of Outside Pixels 


When filtering an image, zero-padding can result in a dark band around the 
edge ofthe image, as shown in this example， 


I= imread(' blood1.tif ' ) ; 

h = ones(5,5)/125; 

I2 = imfilter(I,h); 
imshow(I)，title('original image ') 
figure，imshow(I2)，title(' Filtered image ) 
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0riginal Image Image with Block Border 


To eliminate the zero-padding artifacts aroundthe edge ofthe image, imfilter 
offers an alternative boundary padding method called poraer replicatiomn. In 
border replication, the value of any pixel outside the image is determined by 
replicating the value 人 fom the nearest border pixel. This is illustrated in the 
和 gure below, 


These pixel values are replicated 
from boundory pixels. 
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Figure 7-5: Replicated Boundary Pixels 
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To filter using border replication, pass the additional optional argument 
“replicate' to imfilter. 

I3 = imfilter(I,hn，replicate ' ) ; 

figure，imshow(I3)，title(' Filtered with border replication ) 





Image Border with Replicofion 


The imfilter function Supports other boundary padding options, Such as 
'circular' and 'symmetric'. See the reference page for imfilter for details. 


Mulfidimensional Filtering 


The imfilter function can handle both multidimensional images and 
multidimensional flters. A_ convenient property of filtering is that 和 ltering a 
three-dimensional image with atwo-dimensionalfilteris equivalenttofiltering 
each plane ofthe three-dimensional image individually with the same 
two-dimensional filter. This property makes it easy, for example, to filter each 
color plane of a truecolor image with the same filter. 


rgb = imread(' flowers.tif ); 

h = ones(5,5) / 25; 

rgb2 = imfilter(rgb,h) ; 
imshow(rgb)，title('original image ') 
figure，imshow(rgb2)，title('Filtered image ') 
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0riginal Image Filiered Image 


Relafionship fo Other Filtering Funcfions 

MATLAB has several two-dimensional and multidimensional filtering 
fanctions. The function filter2 performs two-dimensional correlation; conv2 
performs two-dimensional convolution; and convn performs multidimensional 
convolution. Each of these other filtering functions always converts the input 
to double, and the output is always doub1le. Also, each of these other filtering 
fonctions always assumes the input is zero-padded, and they do not Support 
other padding options. 


In contrast, the imfilter function does not convert input images to doub1le. 
The imfilter function also offers aflexible set ofboundarypadding options, as 
described in “Boundary Padding Options”on page 7-10. 


Using Predefined Filter Types 


The fspecial function produces several kinds ofpredefined filters, in the form 
of correlation kernels. After creating a filter with fspecial, you can apply 让 
directly to your image data using imfilter.This example illustrates applying 
an VS]arp 1712asRz1s filter to an intengsity image. The unsharp masking 下 lter 
has the effect ofmaking edges and fine detail in the image more crisp. 
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I= imnread( moon.tif ') 
h fspecial( unsharp 
I2 = imfilter(I,h); 
imshow(I)，title('original image ') 
figure，imshow(I2)，title(' Filtered image ) 


由 





0riginal Image Filtered Image 
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Filter Design 


This section describes working in the 位 equency domain to design filters. Topics 
discussed include: 


e Finite imnpulseresponse (FIR) filters, the class oflinearfilterthatthe toolbox 
SUDports 


e The frequency transformation method, which transforms a one-dimensional 
FIR 和 lter into a two-dimensional FIR 和 lter 


e The frequency sampling methodq, which creates afilter based on a desired 
位 equency response 


e The windowing method, which multiplies the ideal imnpulse response with a 
window function to generate the filter 


se Creating the desired frequency response matrix 
e Computing the frequency response of a filter 
This section assumes you are familiar with working in the frequency domain. 


This topic is discussed in many signal processing and image processing 
textbooks. 





Notfte Most ofthe design methods described in this section work by creating a 
two-dimensional filter 位 om a one-dimensional flter or window created using 
fonctions 位 om the Signal Processing Toolbox. Although this toolbox is not 
required, you may find it qifficult to design filters in the Image Processing 
Toolbox 过 you do not have the Signal Processing Toolbox as wel!. 





FIR Filfers 


The Image Processing Toolbox supports one class of linear filter, the 
two-dimensional finite imnpulse response (FIR) filter. FIR filters have several 
characteristics that make them ideal for image processing in the MATLAB 
environment: 


ee 下 IR flters are easy to represent as matrices of coe 佳 cients. 


e Two-dimensional FIR filters are natural extensiongs of one-dimensional FIR 
丘 ]ters. 
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e There are several well-known, reliable methods for FIR filter design. 
e 上 IR filters are easy to implement. 


e 上 IR flters can be designed to have linear phase, which helps prevent 
distortion . 


Another class of filter, the infinite imnpulse response (IIR) 人 ilter, is not asgs 
Suitable for image processing applications. It lacks the inherent stability and 
ease of design and implementation of the FIR filter. Therefore, this toolbox 
does not provide IIR flter support.， 


Frequency Transformation Method 


The frequency transformation method transforms a one-dimensional FIR filter 
into a two-dimensional FIR filter. The ffequency transformation method 
preserves most of the characteristics ofthe one-dimensional filter, particularly 
the trangsition bandwidth and ripple characteristics. This method uses a 

杂 7amzsfor7aato7 112at17X, a set of elements that defines the 位 equency 
transformation. 


The toolbox function ftrans2 implements the frequency transformation 
method. This function”s default transformation matrix produces filters with 
nearly circular Symmetry. By defining your own transformation matrix, yoOU 
can obtain different symmetries. (See Jae S$.Lim,Tzo-Dimzemsio12aL SQL aq 
77asSe Processi1S, 1990, for details.) 


The frequency transformation method generally produces very good results, as 
it is easier to design a one-dimensional 和 有 lter with particular characteristics 
than a corresponding two-dimensional filter. For instance, the next example 
designs an optimal equiripple one-dimensional FIR filter and uses it to create 
a two-dimensional filter with similar characteristics. The shape ofthe 
one-dimensional 位 equency response is clearly evident in the two-dimensional 
Tesponse， 


b = remez(10,[0 0.4 0.6 1],[1100]); 
hn = ftrans2(b) ; 

[H,w] = freqz(b,1,64，whole ) ; 
colormap (jet(64) ) 
plot(w/pi-1,fftshift(abs(H) )) 
figure，freqz2(h,[32 32]) 
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Figure 7-6: A One-Dimensional Frequency Response (leff) and the 
Corresponding Two-Dimensional Frequency Response (righf) 


Frequency Sampling Method 

The frequency sampling method creates a filter based on a degsired frequency 
response. Given a matrix of points that defines the shape ofthe 他 equency 
response, this method creates afilter whose frequencyresponse passes through 
those points. Frequency sampling places no constraints on the behavior of the 
位 equency response between the given points; usually, the response ripples in 
these areas. 


The toolbox function fsamp2 imnplements frequency sampling design for 
two-dimensional FIR filters. fsamp2 returngs a filter h with a frequency 
response that passes through the points in the input matrix Hd. The example 
below creates an 11-by-11flterusing fsamp2, and plots the frequency response 
of the resulting filter. (The freqz2 function in this example calculates the 
two-dimensional 们 equency response of afilter. See“Computing the Frequency 
Response of a Filter” on page 7-21 for more information.) 


Hd = zeros(11,11); Hd(4:8,4:8) = 1 
[fl1,f2] = freqspace(11，meshgrid ) ; 
mesh(f1,f2,Hd)，axis([-11 -1101.2])，colormap(jet(64)) 
h = fsamp2(Hd) ; 

figure，freqz2(h,[32 32])，axis([-11 -1101.2]) 
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Figure 7-7: Desired Two-Dimensional Frequency Response (leff) and Actual 
Two-Dimensional Frequency Response (righf) 


Notice the ripples in the actual frequency response, compared to the desired 
位 equency response. These ripples are a faondamental problem with the 

位 equency sampling design method. They occur wherever there are sharp 
transitiongs in the desired response. 


You can reduce the spatial extent of the ripples by using a larger filter. 
However, a larger filter does not reduce the height ofthe ripples, and requires 
more computation 刀 me for fltering. To achieve a smoother approximation to 
the desired frequency response, consider using the frequency trangsformation 
method or the windowing method. 


Windowing Method 


The windowing method involves multiplying the ideal impulse response with a 
window function to generate a _ corresponding filter. Like the 位 equency 
sampling method, the windowing method produces a filter whose frequency 
response approximates a desired frequency response. The windowing method， 


however, tends to produce better results than the 他 equency sampling method. 


The toolbox provides two functiongs for window-based filter design, fwind1 and 
fwind2. fwind1 designs a two-dimensional filter by using a two-dqimensional 
window that 让 creates from one or two one-dimensional windows that you 
specify. fwind2 designs a two-dimensional filter by using a specified 
two-dimensional window directly. 
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fwind1 Supports two different methods for making the two-dimensional 
windowsgs it uses: 


e Transforming a single one-dimensional windovw to create a two-dimensional 
windovw that is nearly circularly symmetric, by using a process Similar to 
rotatlon 


e Creating a rectangular, separable window 位 om two one-dimensional 
windows, by computing their outer product 


The example below uses fwind1 to create an 11-by-11 flter 他 om the desired 
他 equency response Hd. Here, the hamming function 位 om the Sizsmal Processi7S 
7oolbox is used to create a one-dimensional window, which fwind1 then 
extends to a two-dimensional window. 


Hd = zeros(11,11); Hd(4:8,4:8) = 1 
[f1,f2] = freqspace(11，meshgrid ) ; 
mesh(f1,f2,Hd)，axis([-11 -1101.2])，colormap(jet(64)) 
h = fwind1(Hd,hamming(11) ) ; 

figure，freqz2(h,[32 32])，axis([-11 -1101.2]) 
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Figure 7-8: Desired Two-Dimensional Frequency Response (leff) and Actual 
Two-Dimensional Frequency Response (righf) 


Creating the Desired Frequency Response Matrix 


The filter design functions fsamp2, fwind2, and fwind2 all create filters based 
on a desired 位 equency response magnitude matrix. You can create an 
appropriate desired frequency response matrix using the fredqspace function. 
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freqspace returns correct, evenly spaced frequency values for any size 
response. If you create a desired frequency response matrix using frequency 
points other than those returned by freqspace, you may get unexpected 
results, Such as nonlinear phase. 


For example, to create a circular ideal lowpass 他 equency response with cuto 任 
at 0.5 use 

[f1,f2] = freqspace(25，meshgrid  ) ; 

Hd = zeros(25,25);j d = Sqrt(f1.^2 + f2.^2) < 0.5; 

Hd(d) = 1; 

mesh(f1,f2,Hd) 











Figure 7-9: ldeal Circular Lowpass Frequency Response 


Note that for this frequency response, the filters produced by fsamp2, fwind1， 
and fwind2 are real. This result is desirable for most image processing 
applications. To achieve this in general, the desired frequency response should 
be symmetric about the 位 equency origin (f1 = 0, f2 = 0). 


Computing fthe Frequency Response of a Filter 


The freqz2 function computes the 他 equency response for a two-dimensional 
flter. With no output arguments, freqz2 creates a mesh plot ofthe ffequency 
response. For example, considqer this FIR 在 lter， 


h =[0.1667 0.6667 0.1667 
0.6667 -3.3333 0.6667 
0.1667 0.6667 0.1667] 
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This command computes and displays the 64-by-64point frequency response of 
h. 


freqz2(h) 


Magnitude 





Frequency 让 


Figure 7-10: The Frequency Response of a Two-Dimensional Filter 


To obtain the frequency response matrix H and the frequency point vectors f1 
and f2, use output arguments 


[H,f1,f2] = fredqz2(h) ; 


fredqz2 normalizes the 位 equencies f1 and f2 so that the value 1.0 correspondsg 
to halfthe sampling frequency, or Tradians. 


For a simple m-by-n response, as shown above, freqz2 uses the 
two-dimensional fast Fourier transform function fft2. You can also specify 
Vectors of arbitrary frequency points, but in this case freqz2 Uses a Slower 
algorithm. 


See“Fourier Transform”on page 8-3 for more information about the fast 
Fourier transform and its application to linear filtering and filter design. 





Transforms 





The usual mathematical representation of an image is a fonction oftwo spatial variables: Ax,y). The 
value ofthe function at a particular location (x,y) represents the intensity ofthe image atthat point. 
The term tra7sform refers to an alternative mathematical representation of an image. 


This section defines several important transforms and shows examples oftheir application to image 
processing. Topics covered include 


Terminology (p. 8-2) Provides definitions of image processing terms used in 
this section 

Fourier Transform (p. 8-3) Defines the Fourier transform and some of its 
applications in image processing 

Discrete Cosine Transform (p. 8-16) Describes the Discrete Cosine Transform (DCT) of an 
image and its application, particularly in image 
compresslion 

Radon Transform (p. 8-20) Describes how the Image Processing Toolbox radon 


fanction computes projectzomns of an image matrix along 
specified directions. 
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Terminology 


An understanding ofthe following terms will help youto use this chapter. Note 
that this table includqes brief definitions of terms related to transforms; a 
detailed discussion ofthese terms and the theory behind transforms is outside 
the scope of this User's Guide. 





Terms Definifions 





Discrete fransform Atransform whose input and output values are discrete samples， 
making it convenient for computer manipulation. Discrete 
transforms implemented by MATLAB and the Image Processing 
Toolbox includqe the discrete Fourier transform (DFT) and the 
discrete cosine transform (DCT). 


Frequency domain The domain in which an image is represented by a sum of periodic 
Signals with varying 位 equency. 


Inverse fransform An operation that when performed on a transformed image， 
produces the original image. 


Spaftial domain The domain in which an image is represented by intensities at given 
points in space. This is the most common representation for image 
data. 

Transform An alternative mathematical representation of an image. For 


example, the Fourier transform is a representation of an image as a 
Sum of complex exponentials ofvarying magnitudes, frequencies， 
and phases. Transforms are useful for a wide range of purposes， 
including convolution, enhancement, feature detection, and 
compresslion . 
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Fourier Transform 


The Fourier transform is a representation of an image as a sum of complex 
exponentials ofvarying magnitudes, 他 equencies, and phases. The Fourier 
transform plays a critical role in a broad range of imnage processing 
applications, including enhancement, analysis, restoration, and compression . 


This section includes the following subsections: 


e“Definition of Fourier Transform2” 


e“Discrete Fourier Transform”on page 8-8, including a discussion of fast 
Fourier transform 


es“Applications”on page 8-11 (sample applications using Fourier transforms) 


Definifion of Fourier Transform 


IAm,Pp) isafuanction oftwodiscrete spatial variables 7 andm,then we define 
the too-qzi7zesio7aL Forvrier tramsform of /7) by the relationship 


oo oo 


(ai1， Oo) 三 >， 汉 所， 几 )e TOamae7oom 


170 = 一 co 有 风 = 一 co 


The variables ol and wo are frequency variables; their units are radians per 
sample. (oj, oo) is often called the Heqrvezcy-Qomzaz7z representation of 

所 7,7) .天 (ol, oo) is a complex-valued function that is periodicboth in oil and 
oa，with period 2 . Because of the periodicity, usually only the range 

-T< 01,0。 <T is displayed. Note that 大 (0,0) is the sum of all the values of 
帮 (7,7) .For this reason, 玉 (0, 0) is often called the comzstazt co7mzpomet or DC 
co1Dpomet of the Fourier transform. (DC stands for direct current; it is an 
electrical engineering term that refers to a constant-voltage power Source, aS 
opposed to a power source whose voltage varies Sinusoidally.) 


The inverse two-dimensional Fourier transform is given by 


区 开 5 
Am,7) = -| | 玉 (o]， Qa)je re daol co。 
47 “oli=-T “os= 一 T 


Roughly speaking, this equation means that /7, 九 ) can be represented as a 
sum of an infinite number of complex exzponentials (sinusoids) with different 
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他 equencies. The magnitude and phase of the contribution at the frequencies 
(ol, oo) are given by F(ol, Oo) . 


Example 


Congsider a function Am,7) that equals 1 within a rectangular region and 0 
everywhere else. 


也 


帮 77272/) 





Figure 8-1: A Rectangular Function 


To simplify the diagram, 扩 7, 了 ) is shown as a continuous function, even 
though the variables 7 and 7 are discrete, 


Fourier Transform 





Figure 8-2 shows the magnitude of the Fourier transform, |F(ol,oo)| ,of 
Figure 8-1 as a mesh plot. The mesh plot ofthe magnitude is a common way to 
visualize the Fourier transform. 



































了 
Recent 





Figure 8-2: Magnitude Image of a Rectangular Function 


The peak at the center ofthe plot is 下 (0, 0) , which is the sum of all the values 
in 成 mm, 刀 ). The plot also shows that 有 (ol1, 2?) has more energy at high 
horizontal 他 equencies than at high vertical 他 equencies. This reflects the fact 
that horizontal cross sections of 风力,7) arenarrow pulses, while vertical cross 
Sectiongs are broad pulses. Narrow pulses have more high-frequency content 
than broad pulses, 
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Another common way to visualize the Fourier transform is to display 
log|(ol， os)| as an image, as in 





Figure 8-3: The Log of the Fourier Transform of a Rectangular Function 


Using the logarithm helps to bring out details ofthe Fourier transform in 
reglions where 玉 (o0l, Oo) is very close to 0. 
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卫 xamples of the Fourier transform for other simple shapes are shown below. 
个 


| 肖 


Figure 8-4: Fourier Transforms of Some Simple Shapes 
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Discretfe Fourier Transform 


Working with the Fourier transform on a computer usually involves a form of 
the transform known as the discrete Fourier transform (DFT). There are two 
principal reasons for using thigs form: 


e The input and output ofthe DFT are both discrete, which makes 让 
convenient for computer manipulations. 


e There is a fast algorithm for computing the DFT known as the fast Fourier 
transform (了 FT). 


The DFT is usually defined for a discrete function /2,7) that is nonzero only 
over the finite region 0<7<M-1land0<sn<N-l.Thetwo-dimensional 
MI-by-VDFT and inverse M-by-VDEFT relationships are given by 


M-1 N-l 吉 
了 = 0,1,...,M- 
碳 (D， 一 二 (27《 MDPme -JJ(2TAV)97 忆 ， 上 ，.… 
(D,9) 之 之 ) 0 
7170 一 7 卫 一 -， 
M-1 N-1l 
1 (2r]M)pm j(2rZV)aon 10 = 0,1 .4 - 
， 全 -二 一 柬 (pp,g)e/ eE 
0 让 已 丰 让 
PP=0 9=0 


The values F(p,9) are the DFT coefficients of Am,7) .The zero-fequency 
coefEGicient, 玉 (0, 0) is often called the “DC component.”DC is an electrical 
engineering term that stands for direct current. (Note that matrix indices in 
MATLAB always start at 1 rather than 0; therefore, the matrix elements 
f(1,1) andF(1,1) correspond to the mathematical quantities 帮 0, 0) and 
下 (0, 0) , respectively.) 


The MATLAB functions fft, fft2, and fftn implement the fast Fourier 
transform algorithm for computing the one-dimensional DFT, two-dimensional 
DFT, and N-dimensional DFT, respectively. The fonctions ifft, ifft2, and 
ifftn compute the inverse DEFT. 
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Relationship to fhe Fourier Transform 
The DFT coefficients 8(p,9) are samples ofthe Fourier transform 屎 (ol1, Oo) . 


RD,9) = Fol, oa) 0,1.,M-1 
2 NE 


Oos = 279LAN 


Example 

Let's construct a matrix f that is similar to the function AP) in the example 
in “Definition of Fourier Transform”on page 8-4. Remember that Noz7272) ig 
equal to 1 within the rectangular region and 0 elsewhere. We use a binary 
image to represent 访 77z7). 


f = zeros(30,30) 
f(5:24,13:17) = 1 
imshow(f，notruesize ') 





Compute and visualize the 30-by-30 DFT of f with these commands. 


F=TfTft2(f); 
F2 = 1og(abs(F)); 
imshow(F2,[-1 5]，notruesize'); colormap(jet); colorbar 
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Figure 8-5: A Discrete Fourier Transform Computed Without Padding 


This plot differs 他 om the Fourier transform displayed on Figure 8-3. First, the 
sampling ofthe Fourier transform is much coarser. Second, the zero-frequency 
coefGcient is displayed in the upper-left corner instead of the traditional 
location in the center. 


We can obtain a finer sampling of the Fourier transform by zero-paddqing ff 
when computing its DFT. The zero-padding and DFT computation can be 
performed in a single step with this command. 


F = fft2(f,256,256) ; 
This command zero-pads f to be 256-by-256 before computing the DFT. 
imshow(1og(abs(F)),[-1 5]); colormap(jet); colorbar 


Fourier Transform 








Figure 8-6: A Discrete Fourier Transform Computed with Padding 


The zero-frequency coefcient, however, is still displayed in the upper-le 化 
corner rather than the center. You can fix this problem by using the fanction 
fftshift, which swapsthe quadrants ofF sothatthe zero-frequency coefficient 
is in the centerT. 

F = fft2(f,256,256) ; 

F2 = fftshift(F) ; 

imshow(1og(abs(F2)),[-1 5]); colormap(jet); colorbar 


The resulting plot is identical to the one on Figure 8-3. 


Applications 


This section presents a few of the many image processing-related applications 
of the Fourier transform. 


Frequency Response of Linear Filters 


The Fourier transform ofthe impulse response of a linear filter gives the 
位 equency response of the filter. The function freqz2 computes and displays a 
和 lter's 位 equency response. The ffequency response of the Gaussian 
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convolution kernel shows thatthis filter passes lovw 位 equencies and attenuates 
high 他 equencies. 

h = fspecial( gausSsian ' ) ; 

freqz2(h) 
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Figure 8-7: The Frequency Response of a Gaussian Filter 


See “Linear Filtering and Filter Design”on page 7-1 for more information 
about linear fltering, filter design, and 他 equency responses， 


Fast Convolution 


A key property of the Fourier transform is that the multiplication oftwo 
Fourier transforms corresponds to the convolution of the associated spatial 
fanctions. This property, together with the fast Fourier transform, forms the 
basis for a fast convolution algorithm 


Suppose that Ais an M-by-N matrixz and B is aP-by-Q matrix. The convolution 
ofAand B can be computed using the following steps: 


1 Zero-pad AandBsothatthey are atleast (M+P-1)-by-(N+Q-l).(Often Aand 
B are zero-padded to a size that is a power of 2 because fft2 is fastest for 
these sizes.) 
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2 Compute the two-dimensional DFT ofA and B using fft2. 
3 Multiply the two DFTs together. 


4 Using ifft2, compute the inverse two-dimensional DFT ofthe result 位 om 
step 3. 


For example， 


A = magic(3); 

B = ones(3); 

A(8,8) = 0 s%5 Zero pad A to be 8 by 8 
B(8,8) = 0; s%5 Zero pad B to be 8 by 8 

C = ifft2(fft2(A) .*fft2(B) ) ; 

C=C(1:5,1:5) 5 Extract the nonzero portion 
C = real(C) 5 Remove imaginary part caused by roundoff error 
GE 


8.0000 9.0000 15.0000 7.0000 6.0000 
11.0000 17.0000 30.0000 19.0000 13.0000 
15.0000 30.0000 45.0000 30.0000 15.0000 

7.0000 21.0000 30.0000 23.0000 9.0000 

4.0000 13.0000 15.0000 11.0000 2.0000 


The FFT-based convolution method is most often used for large inputs. For 
small inputs it is generally faster to use imfilter， 


Locating Image Features 


The Fourier transform can also be used to perform correlation, which is closely 
related to convolution. Correlation can be used to locate features within an 
image; in this context correlation is often called template 7atcAz7S. 


662 


For instance, Suppose you want to locate occurrences of the letter “a”in an 
image containing text. This example reads in text.tif and creategs a template 
image by extracting a letter “a” 位 om 让 . 


bw = imread( text.tif ' ) ; 

a=bw(59:71,81:91); %5Extract one of the letters aa from the image . 
imshow(bw) ; 

figure，imshow(a) ; 
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Figure 8-8: An Image (leff) and the Template to Correlate (righf) 


The correlation ofthe image ofthe letter “a”with the larger image can be 
computed by first rotating the image of“a”by 1809" and then using the 
FFT-based convolution technique described above. (Note that convolution is 
equivalent to correlation ifyourotate the convolution kernel by 180?".) To match 
the template to the image, you can use the fft2 and ifft2 functions, 


C = real(ifft2(fft2(bw) .* fft2(rot90(a,2) ,256,256) ) ) ; 
figure，imshow(C,[])s%Display，Sscaling data to appropriate range ， 
max(C(:)) #%5Find max pixel value in C.， 


ans = 
51.0000 


thresh = 45; %Use a threshold that S a 1itt1le less than max . 
figure，imshow(C > thresh)s“%sDisplay showing pixels over threshold . 





Figure 8-9: A Correlated Image (leff) and its Thresholded Result (righf) 
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The left image above is theresult ofthe correlation; bright peaks correspond to 
occurrences of the letter. The locations of these peaks are indicated by the 
white spots in the thresholdqed correlation image shown on the right. 


Note that you could also have created the template image by zooming in on the 
image andusing the interactive version of imcrop.For example, with text.tif 
displayed in the current fgure window, enter 


Zoom on 
a = imcrop 


To determine the coordinates of features in an image, you can use the pixval 
fanction. 
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Discrefe Cosine Transform 
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The discrete cosine transform (DCT) represents an image as asum ofsinusoids 
of varying magnitudes and frequencies. The dct2 function in the Image 
Processing Toolbox computes the two-dimensional discrete cosine transform 
(DCT) of an image. The DCT has the property that, for atypical image, most of 
the visually significant information about the imasge is concentrated in just a 
few coefficients ofthe DCT. For this reason, the DCT is often used in image 
compression applications. For example, the DCT is at the heart of the 
international standard lossy image compression algorithm known as JPEG 
(The name comes from the working group that developed the standard: the 
Joint Photographic 玉 xperts Group.) 


The two-dimensional DCT of an M-by-N matrix Ais defined as follows. 


M-1l1N-L1 
(2mz+J)p oosX(C27+1)9 0<P<M-1 
Bpo = opoaa >， >》 4mncos 17 COS 2 ，0xy<N_1 
12 =07 刀 =0 
人 RN 
”′_ LV 机 1<sp<M-1l 7 LAN 1l<so<N-1l 


The values 妃 pg are called the _ DCT coejficiets of A. (Note that matrix indices 
in MATLAB always start at 1 rather than 0; therefore, the MATLAB matrix 
elements A(1,1) andB(1,1) correspond to the mathematical quantities A00 
and 刀 00, respectively.) 


The DCT is an invertible transform, and its inverse is given by 


Mi-1L1N-1 
和 FrC2m+1)Peosr(C2m2+1)9 0<7<M -1 
友 7 世 全 光 >》 opodBpacos 217 COS 0 
D=0agq=0 
”′ LVa7 歼 1<p<M-1 7 LV 1<co<sN-1l 
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The inverse DCT equation can be interpreted as meaning that any M-by-N 
matrix A can be written as a sum of MMN functions ofthe form 


fr(271+1)Dp Tr(22+1l) 0<sp<sM-1 
opoacos 一 27 co8 一 DA ， 人 WE 


These faonctions are called the pasis 勾 1ctiomzs ofthe DCT. The DCT coefficients 
已 dg， then, can be regarded as the weijPits applied to each basis function. For 
8 节 y-8 matrices, the 64 basis functions are illustrated by this imasge. 


下 硬 和 轩 





Figure 8-10: The 64 Basis Functions of an 8-by-8 Matrix 


Horizontal ffequencies increase from left to right, and vertical 他 equencies 
increase 位 om top to bottom. The constant-valued basis fanction at the upper 
left js often called the DC basis /jction, andthe corresponding DCT coeffGicient 
Boois often called the DC coejjicrze7t. 


The DCT Transform Maftrix 


The Image Processing Toolbox offers two different ways to compute the DCT. 
The first method is to use the function dct2. dct2 uses an FFT-based algorithm 
for speedy computation with large inputs. The second method is to usetheDCT 
tra7sfor7 1at7zX， Which is returned by the function dctmtx and may be more 
effcient for small square inputs, such as 8-by-8 or 16-by-16. The M-by-M 
transform matrixT is given by 
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1 
2 Dp=0 0<qx<M_1 

爷 二 /4 

放 2 rr(2g+1)p 
肥 cosTC2a+JDP 1<p<M 1 0<co<M-l 
到" 2 上 0 


For an M-by-M matrix A, T*A is an M-by-M matrix whose columns contain the 
one-dimensional DCT of the columns of A. The two-dimensional DCT of A can 
be computed as B=TxAx*T'. Since Tis a real orthonormal matrix, its inverse is 
the same as its transpose. Therefore, the inverse two-dimensional DCT of B is 
given byT'*Bx*T. 


The DCT and Image Compression 


In the JPEG image compression algorithm, the input image is divided into 
8-by-8 or 16-by-16 blocks, and the two-dimensional DCT is computed for each 
block. The DCT coe 低 cients are then quantized, coded, and transmitted. The 
JPEG receiver (or JPEG file reader) decodes the quantized DCT coefficients， 
computes the inverse two-dimensional DCT of each block, and then puts the 
blocks back together into a single image. For typical images, many ofthe DCT 
coe 什 cients have values close to zero; these coefcients can be discarded 
without seriously affecting the quality ofthe reconstructed imasge. 


The example code below computes the two-dimensional DCT of 8-by-8 blocks in 
the input image; qiscards (sets to zero) all but 10 ofthe 64 DCT coefficients in 
each block; and then reconstructs the image using the two-dimensional inverse 
DCT of each block. The transform matrix computation method is used. 


I= imread(' cameraman.tif ' ) ; 
I = im2double(I) ; 


T = dctmtx(8); 

B = blkproc(I,[8 8],，'P1*xxP2',T,T') 

mask = [1 1 1 1 0 0 0 0 
1 1 1 0 0 0 0 0 
1 1 0 0 0 0 0 0 
1 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0]; 
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B2 = blkproc(B,[8 8]，P1.*x' ,mask) ; 
I2 = blkproc(B2,[8 8]，P1*xx*P2 ,T ,T) 
imshow(I)，figure，imshow(I2) 





Although there is some loss ofquality in the reconstructed image, it is clearly 
recognizable, even though almost 85% of the DCT coefficients were discarded. 
To experiment with discarding more or fewer coefficients, and to apply this 
technique to other images, try running the demo function dctdemo. 
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Radon Transform 


The radon transform represents an image as a collection of projections along 
various directions. It is used in areas ranging 位 om Seismology to computer 
V1Slon 

The radon function in the Image Processing Toolbox computes pro7jectzoms of an 
image matrix along specified directions. A _ projection of a two-dimensional 
fonction Acy) is a line integral in a certain direction. For example, the line 
integral of jx,y) in the vertical direction is the projection of foxy) onto the 
X-axis; the line integral in the horizontal qirection is the projection ofAx,y) onto 


the y-axis. Figure 8-11 shows horizontal and vertical projections for a simple 
two-dimensional function. 


Hoy) 


























y 
Projection onfo the y-oxis 




















Projection onfo the X-0xis 


Figure 8-11: Horizontal and Vertical Proiections of a Simple Funcfion 


Projections can be computed along any angle 0. In general, the Radon 
transform of foxcy) is the line integral offparallel to the y” axis 
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R0(Gx) = | jcos0-y“ sing,x sin6+ycos6) ay 


where 


X | -| cos6 singl jx 
2 -Sin6 cos6||y 


The figure below illustrates the geometry ofthe Radon transform. 





尺 gC 关 > 


Figure 8-12: The Geometry of the Radon Transform 


This command computes the Radon transform of I for the angles specified in 
the vector theta 
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[R,xp] = radon(I,theta) ; 


The columns of R contain the Radon transform for each angle in theta. The 
vector xp contains the corresponding coordinates along thex“ -axis. The“center 
pixel” of I is defined to be floor((size(I)+1)/2);this is the pixel on the 
X'-axis _ corresponding to x' = 0. 


The commands below compute and plot the Radon transform at 0" and 45? of 
an image containing a single square object. 


I = zeros(100,100) 
I(25:75，25:75) = 1; 
imshow(I) 


[R,xp] = radon(I,[0 45]); 
figurej plot(xp,R(:,1)); title('R_ {O^o} (x\prime) ) 
figurej plot(xp,R(:,2)); title('R_ {45^0} (x\prime) ) 
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Figure 8-13: Two Radon Transforms of a Square Function 
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Nofte xp is the same for all projection angles. 





The Radon transform for a large number of angles is often displayed as an 
image. In this exzample, the Radon transform for the square image is computed 
at angles from 0" to 180", in 1? increments. 


theta = 0:180 

[R,xp] = radon(I,theta) ; 
imagesc(theta,xp;,R) ; 
title('R_{t\theta}y (X\prime) ) 
Xlabel(' \theta (degrees) ) ; 
yJLabpel('X\prime ') ; 
Set(gca，XTick ' ,0:20:180) ; 
Colormap (hot ) ; 

Colorbar 





40 60 80 100 120 140 160 180 
6(degrees) 


Figure 8-14: A Radon Transform Using 180 Proiecftions 
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Using the Radon Transform to Detect Lines 


The Radon transform is closely related to a common computer vision operation 
known as the Hough transform. You can use the radon function to imnplement 
a form of the Hough transform used to detect straight lines. The steps are: 


1 Compute a binary edge image using the edge function. 


I= imread(' ic.tif' ); 
BW = edge(I) ; 
imshow(I) 
figure，imshow(BW) 





2 Compute the Radon transform ofthe edge imasge. 


theta = 0:179; 

[R,xp] = radon(BW,theta) ; 
figure，imagesc(theta，xp，R); colormap (hot ) 
Xlabel(' \theta (degrees) ' ); ylabel(' X\prime， 
title('R_ Ntheta}y (X\prime) ) 

Colorbar 


) 
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Figure 8-15: Radon Transform of an Edge Image 


3 Find the locations of strong peaks in the Radon transform matrix. The 
locationgs of these peaks correspond to the location of straight lines in the 
original image. 


In this example, the strongest peak in R corresponds to 6 = 94" and 

X“” = -101. The line perpendicular to that angle and located at x“” = -101 is 
shown below, Superimposed in red on the original image. The Radon transform 
geometry is shown in black. 
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Figure 8-16: The Radon Transform Geometry and the Sirongest Peak (Red) 


Notice that the other strong lines parallel to the red line also appear as peaks 
at 0 = 94" in the transform. Also, the lines perpendicular to this line appear 
as peaks at 0 = 4?. 


The Inverse Radon Transform 


The iradon fanction performs the inverse Radon transform, which is 
commonly used in tomography applications. This transform inverts the Radon 
transform (which was introduced in the previous section), and can therefore be 
used to reconstruct images 位 om projection data. 


As discussed in the previous section “Radon Transform”on page 8-21, given an 
image I and aset of angles theta, the function radon can be used to calculate 
the Radon transform. 


R = radon(I,thetal) ; 
The function iradon can then be called to reconstruct the image I. 
IR = Iradon(R,theta) ; 


In the example above, projections are calculated 位 om the original image I. In 
most application areas, there is no orzsimal 7I7zase 位 om which projectiongs are 
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formed. For example, in X-ray absorption tomography, projectiongs are formed 
by measuring the attenuation ofradiation that passegs through a physical 
specimen at different angles. The original image can be thought of as a crosg 
section through the specimen, in which intensity values represent the density 
of the specimen. Projections are collected using special purpose hardware, and 
then an internal image ofthe specimen is reconstructed by iradon.This allows 
for noninvasive imaging ofthe inside ofaliving body or another opaque object. 


iradon reconstructs an image fom parallel beam projections. In paralle! pea77 
Seo1et1iy, each projection is formed by combining aset ofline integrals through 
an image at a specific angle. 


Figure 8-17 below illustrates how parallel beam geometry is applied in X-ray 
absorption tomography. Note that there is an equal number of 7 emitters and 
1. detectors. 也 ach detector measures the radiation emitted 位 om its 
corresponding emitter, and the attenuation in theradiation gives a measure of 
the integrated density, or mass, of the object. This corresponds to the line 
integral that is calculated in the Radon transform. 


The parallel beam geometry used in thefigure is the same as the geometry that 
was described under “Radon Transform”on page 8-21. f(x,y) denotes the 
brightness of the image and Rob0 is the projection at angle 9. 
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Figure 8-17: Parallel Beam Proiections Through an Obiecf 


Another geometry that is commonly used is jn pea1m geometry, in which there 
is one emijtter and 7 detectors. There are methods for resorting sets of fan beam 
projections into parallel beam projections, which can then be used by iradon. 
(For more information on these methods, see Kak & Slaney, Przmciples of 
Co7zDzterizzea TomosraDpAic 7112asi10Ss, IEEE Press, NY, 1988, pp. 92-93.) 


iradon uses the 记 /terea bacpprojectiomn algorithm to compute the inverse Radon 
transform. This algorithm forms an approximation to the image Ibased on the 
projections in the columns ofR.A more accurate result can be obtained byusing 
more projectiongs in the reconstruction. As thenumber ofprojections (the length 
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of theta) increases, the reconstructed image IR more accurately approximates 
the original image I. The vector theta must contain monotonically increasing 
angular values with a constant incremental angle A0. When the scalar Ab is 
known, it can be passedto iradon instead ofthe array oftheta values. Here is 
an example. 


IR = liradon(R,Dtheta) ; 


The filtered backprojection algorithm filters the projections in R and then 
reconstructs the image using the filtered projections. In some cases, noise cam 
be present in the projections. To remove high frequency noise, apply a window 
to the filter to attenuate the noise. Many such windowed filters are available 
in iradon. The example call to iradon below applies a Hamming windovw to the 
filter. See the iradon reference page for more information. 


IR = iradon(R,theta，Hamming ) ; 


iradon also enables you to specify a normalized frequency, D, above which the 
filter has zero response.D mustbe ascalar in the range [0,1]. With this option， 
the frequency axis is rescaled, so that the whole filter is compressed to fit into 
the frequency range [0,D]. This can be usefu]l in cases where the projectiongs 
contain little high frequency information but there is high frequency noise. In 
this case, the noise can be completely suppressed without compromising the 
reconstruction. The following call to iradon sets anormalized frequency value 
of 0.85. 


IR = liradon(R,theta;,0.85) ; 


Examples 

The commands below illustrate how to use radon and iradon to form 
projections 位 om a sample image and then reconstruct the image 位 om the 
projections. The test image is the Shepp-Logan head phantom, which can be 
generated by the Image Processing Toolbox function phantom. The phantom 
image illustrates many ofthe qualities that are found in real-world 
tomographic imaging ofhuman heads. The bright elliptical shell along the 
exterior is analogous to a skull, and the many ellipses inside are analogous to 
brain features or tumors， 
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P = phantom(256) ; 
imshow(P) 





As afirst step the Radon transform ofthe phantom brain is calculated for three 
different sets oftheta values. R1 has 18 projections, R2 has 36 projections, and 
R3 had 90 projections. 


theta1 = 0:10:170; [R1,xp] radon(P,thetal ) ; 


theta2 = 0:5:175;  [R2,xp] = radon(P,theta2) ; 
theta3 = 0:2:178;  [R3,xp]l = radon(P,theta3) ; 


Novw the Radon transform of the Shepp-Logan Head phantom is displayed 
using 90 projections (R3). 


figure，imagesc(theta3 ,xp,R3); colormap (hot); colorbar 
Xlabel(' \theta ); ylabel(' Xx\prime ); 


Radon Transform 
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Figure 8-18: Radon Transform of Head Phantom Using 90 Proiections 


When we look at Figure 8-18, we can see some of the features ofthe input 
image. The first column in the Radon transform corresponds to a projection at 
0" which is integrating in the vertical direction. The centermost column 
corresponds to a projection at 90", which is integrating in the horizontal 
direction. The projection at 90" has a wider profile than the projection at 0" due 
to the larger vertical semi-axis of the outermost elllpse of the phantom. 


Figure 8-19 shows the inverse Radon transforms of R1, R2, and R3, which were 
generated above. Image I1 was reconstructed with the projections in R1, and 让 
is the least accurate reconstruction, because 让 has the fewest projections. I2 
was reconstructed with the 36 projections in R2, and the quality of the 
reconstruction is better, but it is still not clear enough to discern clearly the 
three small ellipses in the lower portion ofthe test imnage. I3 was reconstructed 
using the 90 projections in R3, and the result closely resembles the original 
image. Notice that when the number ofprojections is relatively small (as in I1 
and I2), the reconstruction may include some artifacts from the back 
projection. To avoid this, use a larger number of angles. 
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I1 = Iradon(R1,10) 
I2 = Iradon(R2,5) ; 
I3 = Iiradon(R3,2) 
imshow(I1) 

figure，imshow(I2) 
figure，imshow(I3) 





I3 


Figure 8-19: Inverse Radon Transforms of the Shepp-Logan Head Phantom 
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Morphological Operationgs 





MorpAolosy is atechnique of image processing based on shapes. The value of each pixel in the output 
image is based on a comparison of the corresponding pixel in the input image with its neighbors. By 
choosing the size and shape ofthe neighborhood, you can construct a morphological operation that is 
sengsitive to Specific shapes in the input image. 


This section describes the Image Processing toolbox morphological functions. You can use these 
functions to perform common image processing tasks, such as contrast enhancement, noise removal， 
thinning, skeletonization, 有 lling, and segmentation. Topics covered include 


Terminology (p. 9-2) 


Dilation and Erosion (p. 9-4) 


Morphological Reconstruction (p. 9-19) 


Distance Transform (p. 9-38) 


卫 xample: Marker-Controlled 
Watershed Segmentation (p. 9-41) 


Objects, Regions, and Feature 
Measurement (P. 9-49) 


Lookup Table Operations (p. 9-53) 


Provides definitions of image processing terms used in 
this section 


Defines the two faondamental morphological operations， 
dilation and erosion, and some of the morphological 
image processing operationgs that are based on 
combinations of these operationsg 


Describes morphological reconstruction and the toolbox 
fonctions that use this type of processing 


Describes how to use the bwdist function to compute the 
distance transform of an image 


Steps you through a detailed example of using 
Imorphological image processing 


Describes functions that return information about a 
binary image 


Describes functions that perform lookup table operations 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms Definitions 





Background In a binary image, pixels that are off, ji.e., set to the value 0， 
are conslidered the background. When you view a binary 
image, the background pixels appear black. 


Connecftivity The criteria that describes how pixels in an image form a 
connected group. For example, a connected component is 
“8-connected” 放 diagonally adqjacent pixels are considered to 
be touching, otherwise, it i8“4-connected.”The toolbox 
Supports 2-D as well as multidimensional connectivities. See 
“Pixel Connectivity”on page 9-23 for more information. 


Foreground In a binary image, pixels that are on, ji.e., set to the value 1， 
are considered the foreground. When you view a binary image， 
the foreground pixels appear white. 


Global maxima The highest regional maxima in the image. See the entry for 
regional maxima in this table for more information. 


Global minima The lowest regional minima in the image. See the entry for 
regional minima in this table for more information, 


Morphology Abroad set of image processing operations that procesSs 
images based on shapes. Morphological operations apply a 
structuring element to an input image, creating an output 
image ofthe same size. The most basic morphological 
operationgs are dilation and erosion , 


Neighborhood Aset of pixels that are defined by their locations relative to 
the pixel of interest. A neighborhood can be defined by a 
structuring element or by specifying a connectivity. 


Obiecf Aset ofpixels in a binary image that form a connected group, 
In the context ofthis chapter“object”and“connected 
component”are equivalent. 
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Terms 


Definitions 





Packed binary image 


Regional maxima 


Regional minima 


Structuring element 


A method of compressing binary images that can speed up the 
processing ofthe image. 


A connected set of pixels of constant intengsity 位 om which it ig 
impossible to reach a point with higher intensity without first 
descending; that is, a connected component of pixels with the 
same intensity value, 妃 Surrounded by pixels that all have a 
value less than 志 


A connected set of constant intensity from which it is 
impossible to reach a point with lower intengsity without first 
ascending; that is, a connected component of pixels with the 
same intensity value, 妃 Surrounded by pixels that all have a 
value greater than 上 


Amatrix used to define a neighborhood shape and size for 
Imorphological operations, including dilation and erosion. 
congsists of only 0's and ls and can have an arbitrary shape 
and size. The pixels with values of 1 define the neighborhood. 
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Dilafion and Erosion 


Dilation and erosion are two fandamental morphological operations. Dilation 
adds pixels to the boundaries of objects in an image, while erosion removesg 
pixels on object boundaries. The number of pixels added or removed fom the 
objects in an image depends on the size and shape of the strxctzrzmS ele77ze7t 
used to process the image. 


The following sections describe the dilation and erosion functions in the 
toolbox: 


se“Understanding Dilation and Erosion” 一 This section provides important 
background information about hovw the dilation and erosion functionsg 
operate. 

es“Structuring 了 lements”on page 9-7 一 This section describes structuring 
elements and hovw to create them. 

e“Dilating an Image”on page 9-11 一 This section describes how to use the 
imdilate fanction. 

e“Eroding an Image”on page 9-12 一 This section describes hovw to use the 
imerode function. 

es“Combining Dilation and Erosion”on page 9-14 一 This section dqescribes 
some of the common operationgs that are based on dilation and erosion , 

se“Dilation- and Erosion-Based Functions”on page 9-16 一 This section 
describes toolbox functions that are based on dilation and erosion 


Understanding Dilation and Erosion 


In the morphological qilation and erosion operations, the state of any given 
pixel in the output image is determined by applying arule to the corresponding 
pixel and its neighbors in the input image. The rule used to process the pixels 
defines the operation as a dilation or an erosion. This table lists the rules for 
both dilation and erosion. 
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Table 9-1: Rules for Grayscale Dilation and Erosion 





Operation Rule 





Dilation The value ofthe output pixel is the maxz7z72 value of all 
the pixels in the input pixel's neighborhood. In a binary 
image, 过 any ofthe pixels is set to the value 1, the output 
Pixel is set to 十 


了 rosion The value ofthe output pixel is the 7z7z7272 value of all 
the pixels in the input pixels neighborhood. In a binary 
image, 这 any ofthe pixels is set to 0, the output pixel is 
Set to 0. 





The following fgure illustrates the dilation of a binary image. In the figure， 
note hovw the structuring element defines the neighborhood of the pixel of 
interest, which is circled. (See“Structuring Elements”on page 9-7 for more 
information.) The dqilation fanction applies the appropriate rule to the pixels in 
the neighborhood and assigns a value to the corresponding pixel in the output 
image. In the fgure, the morphological dilation function sets the value of the 
output pixel to 1 because one of the elements in the neighborhood defined by 
the structuring element is on， 
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Figure 9-1: Morphological Processing of a Binary Image 
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The following figure illustrates this processing for a grayscale image. The 

和 gure shows the processing of a particular pixel in the input image. Note how 
the function applies the rule to the input pixels neighborhood and uses the 
highest value of all the pixels in the neighborhood as the value ofthe 
corresponding pixel in the output image, 
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Figure 9-2: Morphological Processing of Grayscale Images 


Processing Pixels at Image Borders 


Morphological functions position the origin ofthe structuring element, its 
center element, over the pixel of interest in the input image. For pixels at the 
edge ofan image, parts ofthe neighborhood defined bythe structuring element 
can extend past the border of the image, 


To process border pixels, the morphological functions assign a value to these 
undefined pixels, as ifthe functions hadpaddedthe image with additional rowsg 
and columns.The value ofthese“padding”pixels varies for dilation and erosion 
operations. The following table details the padding rules for dilation and 
erosion for both binary and grayscale images. 


Dilation and Erosion 





Table 9-2: Rules for Padding Images 





Operation Rule 





Dilation Pixels beyond the image border are assigned the 
1277277270 Value afforded by the data type. 
For binary images, these pixels are assumed to be set to 0. 
For grayscale images, the minimum value for uint8 
images 18 0. 


了 rosion Pixels beyond the image border are assigned the 
72QXI7272 Value afforded by the data type. 
For binary images, these pixels are assumed to be set to 1. 
For grayscale images, the maximum value for uint8 
Images 18 255. 








Nofte By using the minimum value for qilation operations and the maximum 
value for erosion operations, the toolbox avoidqs poraer ejjfects, where regionsg 
near the borders of the output image do not appear to be homogeneous with 
the rest of the image. For example, iferosion padded with a minimnum value， 
eroding an image would result in a black border around the edge ofthe output 
image. 





Siructuring Elements 


An essential part ofthe dilation and erosion operationgs is the structuring 
element used to probe the input image. Two-dimensional, or jat, structuring 
elements consist of a matrix of 0s and ls, typically much smaller than the 
image being processed. The center pixel of the structuring element, called the 
o7151P, identifies the pixel of interest 一 the pixel being processed. The pixels in 
the structuring element containing ls define the mezSsAporAooa of the 
structuring element. These pixels are also considered in the dilation or erosion 
processing. Three dimensional, or oz1jlat, structuring elements use 0 and 178 
to define the extent of the structuring element in the x- andy-plane and add 
height values to define the third dimension. 
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The Origin of a Structuring Element 


The morphological functions use this code to get the coordinates ofthe origin of 
structuring elements of any size and dimension. 


origin = floor((Size(nhood)+1)/2) 


(In this code，nhood is the neighborhood defining the structuring element. 
Because structuring elements are MATLAB objects, you cannot use the Size of 
the STREL object itself in this calculation. You must use the STREL getnhood 
method to retrieve the neighborhood ofthe structuring element 位 om the STREL 
object. For information about other STREL object methods, see the strel 
function reference page.) 


For example, the following illustrates a diamond-shaped structuring element. 


Siruduring Element 0rigin 
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Figure 9-3: Origin of a Diamond-Shaped Structuring Element 


Creating a Structuring Element 

The toolbox dilation and erosion functions accept structuring element objects， 
called a STREL. You use the strel function to create STRELs of any arbitrary 
Size and shape. The strel function also includes built-in Support for many 
common shapes, such as lines, diamonds, disks, periodic lines, and balls. 





Note You typically choose a structuring element the same size and shape as 
the objects you want to process in the input image. For example, to find lines 
in an image, create a linear structuring element. 
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For example, this code creates aflat, diamond-shaped structuring element. 


strel( diamond ' ,3) 


Se 
Se = 


Flat STREL object containing 25 neighbors . 
Decomposition: 3 STREL objects containing a total of 13 neighbors 


Neighborhood : 
0 0 0 1 0 0 0 
0 0 1 1 1 0 0 
0 1 1 1 1 1 0 
1 1 1 1 1 1 1 
0 1 1 1 1 1 0 
0 0 1 1 1 0 0 
0 0 0 1 0 0 0 


Structuring Element Decomposifion 
To enhance performance, the strel function may break structuring elements 
into smaller pieces, a technique known as s 杂 xctz7i72S ele7ae1t Qeco72DosztIo7. 


For example, qilation by an 11-by-11 square structuring element can be 
accomplished by dilating first with a 1-by-11 structuring element, and then 
with an 11-by-l structuring element. This results in a theoretical speed 
improvement of a factor of 5.5, although in practice the actual speed 
improvement is Somewhat less. 


Structuring element decompositions used for the 'disk' and 'bal1' shapes 
are approximations; all other decompositions are exact. Decomposition is not 
used with arbitrary structuring elements, unless it is a flat structuring 
element whose neighborhood is all 1s. 


To view the sequence of structuring elements used in a decomposition, use the 
STREL getsequence method. The getsedquence fanction returns an arTray ofthe 
structuring elements that form the decomposition. For example, here are the 
structuring elements created in the decomposition of a diamond shaped 
structuring element. 


Sel = Strel('diamond ' ,4) 

Sel = 

Flat STREL object containing 41 neighbors . 

Decomposition: 3 STREL objects containing a total of 13 neighbors 
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Neighborhood : 
0 0 0 0 1 0 
0 0 0 1 1 1 
0 0 1 1 1 1 
0 1 1 1 1 1 
1 1 1 1 1 1 
0 1 1 1 1 1 
0 0 1 1 1 1 
0 0 0 1 1 1 
0 0 0 0 1 0 


Seq = getsedquence(Sel) 
Seq = 
3x1 array of STREL objects 


seq(1) 
ans = 
Flat STREL object containing 5 neighbors ， 


Neighborhood : 
0 1 0 
1 1 1 
0 1 0 

Seq(2) 

ans = 


Flat STREL object containing 4 neighbors ， 


Neighborhood : 
0 1 0 
1 0 1 
0 1 0 

Seq(3) 

ans = 


Flat STREL object containing 4 neighbors ， 


和 


口 口 口 一 一 一 口 口 口 
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Nelighborhood : 
0 0 1 0 0 
0 0 0 0 0 
1 0 0 0 1 
0 0 0 0 0 
0 0 1 0 0 


Dilating an Image 
To dilate an image, use the imdilate function. The imdilate function accepts 
two primary arguments: 


e The input image to be processed (grayscale, binary, or packed binary image) 


e A structuring element object, returned by the strel function, or a binary 
matrix defining the neighborhood of a structuring element 


imdilate also accepts two optional arguments: PADOPT and PACKOPT. The 
PADOPT argument affects the size ofthe output image. The PACKOPT argument 
identifies the input image as packed binary. (See the bwpack reference page for 
information about binary image packing.) 


This example dilates a simple binary image containing one rectangular object. 


BW = zeros(9,10) 
BW(4:6,4:7) = 1 


BW = 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 1 1 1 1 0 0 0 
0 0 0 1 1 1 1 0 0 0 
0 0 0 1 1 1 1 0 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 


To expand all sides of the foreground component, the example uses a 3-by-3 
square structuring element object. (For more information about using the 
strel function, see“Structuring 了 lements”on page 9-7.) 
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SE = Strel('Ssdquare ,3) 
SE = 


Flat STREL object containing 3 neighbors ， 


Neighborhood : 
1 1 1 
1 1 1 
1 1 1 


To dilate the image, pass the image, BW, and the structuring element, SE, to the 
imndilate function. Note how dilation adds a rank of ls to all sides ofthe 
foreground object. 


BW2 = imdilate(BW,SE) 
BW2 = 


Coooeoeoeoeeececee 
Coooeoeoeoeeoecececee 
口 口 区 心 品 
口 口 一 一 一 一 一 口 品 
口 口 一 一 一 一 一口 品 
口 口 一 一 一 一 = 一口 品 
口 口 一 一 一 一 = 一口 品 
口 口 一 一 一 一 一 口 口 
Doooeoeoeoeecececee 
oooeoeoeoeeececee 


Eroding an Image 

To erode an image, usethe imerode function. The imerode fanction accepts two 
primary arguments: 

e The input image to be processed (grayscale, binary, or packed binary image) 


eAastructuring element object, returned by the strel fanction, or a binary 
matrix defining the neighborhood of a structuring element 


imerode also accepts three optional arguments: PADOPT, PACKOPT, and M. 


The PADOPT argument affects the size ofthe output image. The PACKOPT 
argument identifies the input image as packed binary. Ifthe image is packed 
binary, M identifies the number ofrows in the original image. (See the bwpack 
reference page for more information about binary image packing.) 
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The following example erodes the binary image, circbw.tif: 


1 Read the image into the MATLAB workspace, 
BW1 = imread(' circbw.tif ' ) ; 
2 _ Create a structuring element. The following code creates a diagonal 


structuring element object. (For more information about using the stre1 
fonction, see“Structuring Elements”on page 9-7.) 


SE = Strel('arbitrary ,eye(5) ) 
SE= 


Flat STREL object containing 5 neighbors . 


Neighborhood : 
1 0 0 0 0 
0 1 0 0 0 
0 0 1 0 0 
0 0 0 1 0 
0 0 0 0 1 


3 Call the imerode fanction, passing the image, BW, and the structuring 
element, SE, as arguments. 


BW2 = imerode(BW1,SE) ; 


Notice the diagonal streaks on the right side ofthe output image. These are 
due to the shape ofthe structuring element. 


imshow(BW1 ) 
figure，imshow(BW2) 
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Figure 9-4: Circbw.tif Before and After Erosion with a Diagonal Siructuring 
Element 


Combining Dilation and Erosion 


Dilation and erosion are often used in combination to implement image 
processing operations. For example, the definition of a morphological ope7z7g 
of an image is an erosion followed by a dilation, using the same structuring 
element for both operations. The related operation, morphological closi7ms of an 
image is the reverse: 过 consists ofdqilation followed by an erosion with the same 
structuring element. 


The following section uses imdilate and imerode to jllustrate how to 
implement a morphological opening. Note, however, that the toolbox already 
includes the imopen function which performs this processing. The toolbox 
includes functions that perform many common morphological operations. See 
“Dilation- and Erosion-Based Functions”on page 9-16 for a complete list. To 
see Some of the morphology functions used in an extended example, see 
“PPxample: Marker-Controlled Watershed Segmentation”on page 9-41. 


Morphological Opening 

You can use morphological opening to remove small objects 位 om an image 
while preservingthe shape and size oflarger objects in the image.For exzample， 
you can use the imopen function to remove all the circuit lines fom the original 
circuit image, circbw.tif, creating an output image that contains only the 
rectangular shapes of the microchips. 


Dilation and Erosion 





To morphologically open the image, perform these stepsg: 


1 _ Create a structuring element. 


SE = strel('rectangle ，[40 30]) 


The structuring element should be large enough to remove the lines when 
you erode the image, but not large enough to remove the rectangles. It 
should consist of all 1s, so it removes everything but large continuous 
patches of foreground pixels. 


2 Erode the image with the structuring element. 


BW1 = imread(' circbw.tif ) ; 
BW2 = imerode(BW1,SE) ; 
imshow(BW2 ) 


This removes all of the lines, but also shrinks the rectangles. 





3 Torestore therectangles to their original size, qilate the eroded image using 
the same structuring element，SE. 


BW3 = imdilate(BW2,SE) ; 
imshow(BW3 ) 
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Dilation- and Erosion-Based Funcfions 

This section describes two common image processing operations that are based 
on dilation and erosion: 

e Skeletonization 

e Perimeter Determination 

This table lists other fuanctions in the toolbox that perform common 


morphological operations that are based on dilation and erosion. For more 
information about these functions, see their reference pages. 


Table 9-3: Dilation- and Erosion-Based Funcfions 





Function Morphological Definition 





bwhitmiss Logical AND of an image, eroded with one Structuring 
element, and the image's complement, eroded with a 
second structuring element. 


imbothat Subtracts the original image 位 om a morphologically 
closed version ofthe image. Can be used to find 
intensity troughs in an image, 


imclose Dilates an image, and then erodes the dilated image 
using the same structuring element for both operations. 
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Table 9-3: Dilation- and Erosion-Based Funcfions 





Function Morphological Definifion 





imopen Erodes an image and then dilates the eroded image 
using the same structuring element for both operations. 


imtophat Subtracts a morphologically opened image fom the 
original image. Can be used to enhance contrast in an 
Image. 





Skeletonization 

To reduce all objects in an image to lines, without changing the essential 
Structure of the image, use the bwmorph function. This process is known asgS 
SReleto12zza 龙 0O7. 


BW1 = imread(' circbw.tif ' ) ; 
BW2 = bwmorph(BW1，skel' Inf) ; 
imshow(BW1 ) 
figure，imshow(BW2 ) 





Figure 9-5: Circbw.tif Before and After Skeletonizaftion 


Perimeter Determinafion 

The bwperim fanction determines the perimeter pixels ofthe objects in a binary 
image. A pixel is considered a perimeter pixel itit satisfies both ofthese 
criterial: 


e The pixel is on. 
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e One (or more) of the pixels in its neighborhood is off. 


For example, this code finds the perimeter pixels in a binary image of a circuit 
board， 


BW1 = imread(' circbw.tif ) ; 
BW2 = bwperim(BW1 ) ; 
imshow(BW1 ) 
figure，imshow(BW2 ) 





Figure 9-6: Circbw.tif Before and After Perimeter Determinaftion 
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Morphological Reconstrucfion 


Morphological reconstruction is another major part of morphological image 
processing. Based on dilation, morphological reconstruction has these unique 
properties: 


e Processing is based on two images, a marker and a mask, rather than one 
image and a structuring element 
e Processing repeats until stability; i.e., the image no longer changes 


e Processing is based on the concept of connectivity, rather than a structuring 
element. 


The following sections describe the functiongs in the toolbox that are based on 
Imorphological reconstruction: 


e“Marker and Mask”- This section describes the faondamental reconstruction 
function,， imreconstruct, and provides background information about 
Imorphological reconstruction. 


“Pixel Connectivity”- This section describes how pixel connectivity affects 
Imorphological reconstruction. 


“Flood-Fill Operations”-- This section qdqescribes hovw to use the imfil1 
function, which is based on morphological reconstruction. 


“Finding Peaks and Valleys”-- This section describes a group of functions, all 
based on morphological reconstruction, that process image extrema, ji.e., the 
areas of high- and low-intensity in images, 


NMarker and Mask 


Morphological reconstruction processes one image, called the ma7per,based on 
the characteristics of another image, called the asR. The high-points, or 
peaks, in the marker image specify where processing begins. The processing 
continues until the image values stop changing. 


To illustrate morphological reconstruction, consider this simple image. 姜 
contaings two primary regions, the blocks of pixels containing the value 14 and 
18. The background is primarily all set to 10, with some pixels set to 11. 
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A= [10 10 10 10 10 10 10 10 10 10 ; 
10 14 14 14 10 10 11 10 11 10 ; 
10 14 14 14 10 10 10 11 10 10 ; 
10 14 14 14 10 10 11 10 11 10 ; 
10 10 10 10 10 10 10 10 10 10 ; 
10 11 10 10 10 18 18 18 10 10 ; 
10 10 10 11 10 18 18 18 10 10 ; 
10 10 11 10 10 18 18 18 10 10 ; 
10 11 10 11 10 10 10 10 10 10 ; 
10 10 10 10 10 10 11 10 10 101] ; 


To morphologically reconstruct this image, perform these steps: 


1 _ Create a marker image. As with the structuring element in dilation and 
erosion, the characteristics of the marker image determine the processing 
performed in morphological reconstruction. The peaks in the marker image 
should identify the location of objects in the mask imasge that you want to 
emphasize. 


One way to create a marker image is to subtract a constant 位 om the mask 
Image, using imsubtract. 


marker = imsubtract(A,2) 

marker = 
8 8 8 8 8 8 8 8 8 8 
8 12 12 12 8 8 9 8 9 8 
8 12 12 12 8 8 8 9 8 8 
8 12 12 12 8 8 9 8 9 8 
8 8 8 8 8 8 8 8 8 8 
8 9 8 8 8 16 16 16 8 8 
8 8 8 9 8 16 16 16 8 8 
8 8 9 8 8 16 16 16 8 8 
8 9 8 9 8 8 8 8 8 8 
8 8 8 8 8 8 9 8 8 8 


2 Call the imreconstruct fanction to morphologically reconstruct the image. 
In the output image, note how all the intensity fluctuations except the 
intensity peak have been removed. 
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recon = limreconstruct(marker，mask) 

recon = 
10 10 10 10 10 10 10 10 10 10 
10 12 12 12 10 10 10 10 10 10 
10 12 12 12 10 10 10 10 10 10 
10 12 12 12 10 10 10 10 10 10 
10 10 10 10 10 10 10 10 10 10 
10 10 10 10 10 16 16 16 10 10 
10 10 10 10 10 16 16 16 10 10 
10 10 10 10 10 16 16 16 10 10 
10 10 10 10 10 10 10 10 10 10 
10 10 10 10 10 10 10 10 10 10 


Understanding Morphological Reconstruction 


Morphological reconstruction can be thought of conceptually as repeated 
dilations ofthe marker image until the contour ofthe marker image fits under 
the mask image. In this way, the peaks in the marker image“spread out”,， or 
dilate， 


This fgure illustrates this processing in 1-D. Each successive dilation is 
congstrained to lie underneath the mask. When forther dilation ceases to 
change the image, processing stops. The final qilation is the reconstructed 
image. (Note: the actual implementation ofthis operation in the toolbox is done 
much more efEciently. See the imreconstruct reference page for more details.) 
The figure shows the successive dilations of the marker. 


9-21 


9 AMAorphological Operations 









小 
届 


志  NMarker 





中- Reconstructed 
Imoage 








je 


Figure 9-7: Repeated Dilations of Marker Image, Constrained by Mask 
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Pixel Connecfivity 


Morphological processing starts at the peaks in the marker image and spreads 
throughout the rest ofthe image based on the connectivity of the pixels. 
Connectivity defines which pixels are connected to other pixels. 


For example, this binary image contains one foreground object 一 all the pixels 
that are set to 1. Ifthe foreground is 4-connected, the image has one 
background object, all the pixels are set to 0. However, ifthe foreground is 
8-connected, the foreground makes a closed loop and the image has two 
separate background objects: the pixels in the loop and the pixels outside the 
loop. 


人 
口 口 一 口 口 口 一 吕 
口 口 一 口 口 口 一 口 
口 口 一 口 口 口 一 口 
人 
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Defining Connectivity in an Image 


The following table lists all the standard two- and three-dimensional 
connectivities Supported by the toolbox. See these sectiongs for more 
information: 


e“Choosing a Connectivity” 
e“Specifying Custom Connectivities” 
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Table 9-4: Supported Connecfivifies 





Two-Dimensional Connectivities 



























































4-connected Pixels are connected 计 their edges touch. This 
means thatapair ofadjoining pixels are part ofthe 4 
same object only 这 they are both on and are ， So 
connected along the horizontal or vertical qirection. Y 
8-connected Pixels are connected 这 their edges or corners touch. 
This meangs thatiftwo adjoining pixels are on,they 小 
are part ofthe same object, regardless of whether -后 可 
they are connected along the horizontal, vertical, or 
diagonal qirection . V 
Three-Dimensional Connecfivities 
6-connected Pixels are connected iftheir faces touch. 6 foces 
18-connected “了 Pixels are connected itheir faces or edges touch. 6faces 
12 edges 
忆 
26-connected “Pixels are connected iftheir faces, edges, or corners 6 fuces + 
touch. 12 edges + 
8 corners 
- 别 一 
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Choosing a Connectivity 

The type ofneighborhood you choose affects the number of objects found in an 
image and the boundaries ofthose objects. For this reason, the results of many 
morphology operations often differ depending upon the type connectivity you 
Specify. 


For example, 坟 you specify a 4-connected neighborhood, this binary image 
contaings two objects; 计 you specify an 8-connected neighborhood, the image has 
one object. 


人 
口 口 一 一 口 
口 口 一 一 口 
一 一 口 口 口 
一 一 口 口 口 
口 口 口 口 口 


Specifying Custom Connecfivifies 

You can also define custom neighborhoods by specifying a 3-by-3-by-.…-by-3 
array of 0s and 1s. The 1-valued elements define the connectivity ofthe 
neighborhood relative to the center element. 


For exzample, this array defines a“North/South”connectivity that has the effect 
of breaking up an image into independent colummns. 


CONN = [ 0 1 0) 0 10;010] 
CONN = 

0 1 0 

0 1 0 

0 1 0 





Note Connectivity arrays must be Symmetric about their center element. 
Also, you can use 2-D connectivity array with a 3-D image; the connectivity 
affects each“page”in the 3-D imasge. 
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Flood-Fill Operaftions 


The imfil1 fanction performs a Jooa-Hi/L operation on binary and grayscale 
images. For binary images, imfi11 changes connected background pixels (0S) 
to foreground pixels (1s), stopping when it reaches object boundaries. For 
grayscale images, imfi1l1 brings the intengsity values of dark areas that are 
SuUrrounded by lighter areas up to the same intensity level as surrounding 
pixels. (In effect, imfi11lremoves regional minimathat arenot connected to the 
image border. See“Finding Areas of High- or Low-Intengsity”for more 
information.) This operation can be useful in removing irrelevant artifacts 

位 om images. 


This section includes information about: 
e Specifying the connectivity in flood-fll operations 


e Specifying the starting point for binary image fi1] operationgs 
e Filling holes in binary or grayscale images 


Specifying Connecfivity 
For both binary and grayscale images, the boundary of the fl]] operation is 
determined by the connectivity you Specify. 





Notfte imfilldiffers 们 om the other object-based operationgs in that it operates 
on DacpsroxPa pixels. When you specify connectivity with imfil11, you are 
specifying the connectivity of the background, not the foreground. 





The implications of connectivity can be jillustrated with this matrix， 


BW = [ 0 0 0 0 0 0 0 0 1 
0 1 1 1 1 1 0 0 
0 1 0 0 0 1 0 0 
0 1 0 0 0 1 0 0 
0 1 0 0 0 1 0 0 
0 1 1 1 1 0 0 0 
0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0] 


Ifthe background is 4-connected, this binary image contains two separate 
background elements (the part inside the loop and the part outside). Ifthe 
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background is 8-connected, the pixels connect diagonally, and there is only one 
background element. 


Specifying the Starfing Point 

For binary images, you can Specify the starting point of the fll operation by 
passing in the location subscript or by using imfill in interactive mode， 
selecting starting pixels with a mouse. See the reference page for imfil1l for 
more information using imfi11l interactively. 


For example, 证 you call imfi11, Specifying the pixel BW(4,3) as the starting 
point, imfil11 only flls in the inside ofthe loop because, by default, the 
background is 4-connected. 


imfilL(BW,[4 3]) 


ans 


H 开 you specify the same starting point, but use an 8-connected background 
connectivity, imfil18lls in the entire image. 


imfil1(BW,[4 3],8) 


ans 
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Filling Holes 


Acommon use ofthe flood-fill operation is to 下 1 “holes”in images.For example， 
Suppose you have an image, binary or grayscale, in which the foreground 
objects represent Spheres. In the image, these objects should appear as disks， 
but instead are donut shaped because ofreflections in the original photograph. 
Before doing any further processing ofthe image, you may want to first 有 1]] in 
the“donut holes”using imfil1. 


Because the use of flood-fill to 帮 ] holes is so common, imfill includes Special 
Syntax to Support it for both binary and grayscale images. In this syntax, yoU 
just specify the argument 'holes';youdonothaveto specify starting locationgs 
in each hole. 


To illustrate, this example flls holes in a grayscale image of blood cells. 


blood = imread( blood1 .tif ' ) ; 

imshow(b1ood ) 

blood2 = imcomplement(imfil1l(imncomplement(blood)，holes ) ) | 
figure，imshow(b1ood2 ) 





0rigindl After Filling Holes 
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Finding Peaks and Valleys 


Grayscale images can be thought of in three-dimensions: the x- and y-axXes 
represent pixel positions and the z-axes represents the intengsity of each pixel. 
In this interpretation, the intensity values represent elevationgs as in a 
topographical map. The areas of high-intensity and low-intensity in an image， 
peaks and valleys in topographical terms, can be important morphological 
features because they often mark relevant image objects. 


For example, in an image of several spherical objects, points of high intensity 
could represent the tops of the objects. Using morphological processing, these 
maxima can be used to identify objects in an image. 


This section covers these topics: 


“Understanding the Maxima and Minima Functions” 


“Findqing Areas of High- or Low-Intensity” 


“Suppressing Minima and Maxima” 


“Imposing a Minima” 


Understanding the Maxima and Minima Funcfions 

An image can have multiple regional maxima or minima but only a single 
global maxima or minima. Determining image peaks or valleys can be used to 
create marker images that are used in morphological reconstruction. For a 
detailed example, see “Example: Marker-Controlled Watershed Segmentation” 
on page 9-41. 


This fgure illustrates the concept in 1-D. 
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Finding Areas of High- or Low-lntensity 

The toolbox includes functions that you can use to find areas of high- or 

low-intensity in an image: 

e The imregionalmax and imregionalmin fanctions identify a/L regional 
miniima or maxima， 


e The imextendedmax and imextendedmin functions identify all regional 
minima or maxima that are greater than or less than a specified threshold. 


The fanctions accept a grayscale image as input and return a binary image as 
output. In the output binary image, the regional minima or maxima are set to 
1; all other pixels are set to 0. 
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For example, this simple image contaings two primary regional maxima, the 
blocks of pixels containing the value 13 and 18, and several smaller maxima， 


Set to 11. 
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The binary image returned by imregionalmax pinpoints all these regional 


Iaxima. 


B = imregionalmax(A) 


B = 


人 


You may wantto only identify areas ofthe image where the change in intensity 
is extreme; that is, the difference between the pixel and neighboring pixels is 
greater than (or less than) a certain threshold. For example, to find only those 
regional maxima in the sample image,A,that are atleasttwo units higher than 
their neighbors, use imextendedmax. 
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B = imextendedmax(A,2) 
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Suppressing Minima and Maxima 


In an image, every small fluctuation in intensity represents a regional minima 
or maxima. You may only be interested in significant minima or maxima and 
not in these smaller minima and maxima caused by background texture， 


To remove the less significant minima and maxima but retain the signjficant 
minima and maxima,usethe imhmax or imhminfuanctions. With these functions， 
you can Specify a contrast criteria or threshold level, 凡 , that suppresses all 
maxima whose height is less than 灵 or whose minima are greater than 灵 . 





Notfte The imregionalmin, imregionalmax, imextendedmin and 
imextendedmax functions return a binary image that marks the locations of 
the regional minima and maxima in an image. The imhmax and imhmin 
fonctions produce an altered image. 





For example, this simple image contains two primary regional maxima, the 
blocks of pixels containing the value 14 and 18, and several smaller maxima， 
Set to 11. 
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To eliminate all regional maxima except the two Significant maxima, use 


imhmax, specifying a threshold value of 2. Note that imhmax only affects the 


maxima; none of the other pixel values are changed. The two significant 
maxima remain, although their heights are reduced. 
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This fgure takes the second rovw from the sample imagetoillustrate in 1-D how 
imhmax changes the profile of the imasge. 
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Imposing a Minima 

You can emphasize specific minima (dark objects) in an image using the 
imimposemin function. The imimposemin function uses morphological 
reconstruction to eliminate all minima from an the image except the minima 
you Specify. 

Toillustrate the process ofimnposing aminima, this code creates a simple image 
containing two primary regional minima and several other regional minima. 


8 = 2j 
2 : = 7 
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Creating a Marker Image 


To obtain an image that emphasizes the two deepest minima and removes al 
others, create a marker image that pinpoints the two minima of interest. You 
can create the marker image by explicitly setting certain pixels to specific 
values or by using other morphological functions to extract the features yoUu 
want to emphasize in the mask imasge. 
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This example uses imextendedmin to get a binary image that shows the 
locationgs of the two deepest minima. 
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Applying the Marker Image to the Mask 


Now use imimposemin to create new minima in the mask image at the points 

specified by the marker image. Note how imimposemin sets the values of pixels 
specified bythe marker image to the lowest value Supported bythe datatype (0 
for uint8 values). imimposemin also changes the values of all the other pixels 
in the image to eliminate the other minima. 


I = imimposemin(mask,marker) 


11 11 11 11 11 11 11 11 11 11 


11 8 8 8 11 11 11 11 11 11 
11 8 0 8 11 11 11 11 11 11 
11 8 8 8 11 11 11 11 11 11 
11 11 11 11 11 11 11 11 11 11 
11 11 11 11 11 0 0 0 11 11 
11 11 11 11 11 0 0 0 11 11 
11 11 11 11 11 0 0 0 11 11 


11 11 11 11 11 11 11 11 11 11 
11 11 11 11 11 11 11 11 11 11 


This fgure illustrates in 1-D how imimposemin changes the profile ofrow 2 of 
the imasge. 
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Figure 9-8: Imposing a Minima 


一 


9-37 


9 AMAorphological Operations 





Distance Transform 


The distance transform provides a metric or measure of the separation of 
points in the image. The Image Processing Toolbox provides a function, bwdist， 
that calculates the distance between each pixel that is set to off (0) and the 
nearest nonzero pixel for binary imasges. 


The bwdist function Supports several distance metrics, listed in Table 9-5， 
Distance Metrics 


Table 9-5: Distance Metrics 








































































































Distance Metric Descripiion 册 ustration 
了 uclidean The Euclidean distance is the 
straight-line distance between two 0 | 0 人 1.41| 1.011.41 
机 0 |110 1.0 | 0.01 1.0 
0 101o0 1.41| 1.0|11.41 
Image Disionce fransform 
City Block The City Block distance metric 
measures the path between the 0 | 9 2 | 11|12 
pixels based on a 4-connected 冰 | 让 | 辣 
Deighborhood. Pixels wphose edges 
touch are 1 unit apart; pixels 0 1901|19 2|1|: 
diagonally touching are 2 units Imoge Disionce transform 


apart. 
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Table 9-5: Distance Metrics (Confinued) 





Disfance Mefric 


Descripfion 咱 ustration 





Chessboard 


Quasi-Euclidean 


The Chessboard distance metric 
measures the path between the 0 10149 1 1 
pixels based on an 8-connected 0 | 1 有 
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or corners touch are 1 unit apart. 0|1019 加 开 到 村 
Image Distance transform 
The Quasi-Euclidean metric 
measures the total Euclidean 019|909191 128122129232.8 
distance along a set ofhorizontal， 0|010|010 1 122|1141.0|1.4|2.2 
vertical, and qiagonal line 0|10 本 2.0| 1.0| 011.0| 2.9 
Segments. 0|0|10|0l0o112211.41101.4| 2.2 
010|1o|lololi 128|12.2|2.0|2.2| 2.8 
Image Distance transform 





This example creates a binary image containing two overlapping circular 
objects. 


center1 = -10; 

Center2 -Center1 

dist = Sdqrt(2*(2*center1)^2) ; 

radius = dist/2 * 1.4; 

1Lims = [floor(center1-1.2*radius) ceil(center2+1.2xradius) ]; 
[x,y] = meshgrid(1Lims(1):1Lims(2)); 

bw1 = Sqrt((x-center1).^2 + (y-center1).^2) <= radius ; 

bw2 = Sqrt((x-center2).^2 + (y-center2).^2) <= radius ; 

bw = bw1 | bw2; 

figure，imshow(bw)，title('bw') 
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To compute the distance transform ofthe complement ofthe binary image, use 
the bwdist function. In the image ofthe distance transform, note how the 
center of the two circular areas are white. 


D = bwdist(~bw) ; 
figure，imshow(D,[])，title('Distance transform of ~bw') 
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Example: Marker-Controlled Watershed Segmentation 


This example illustrates how to use many different morphology functiongs in 
combination to accomplish an image processing task: segmentation. In 
segmentation, objects in an imagethat are touching each other are divided into 
Separate objects. (To see other extended examples, view the Image Processing 
Toolbox Morphology demos.) 


The example performs these steps: 


e“Step 1: Read in Images” 


“Step 2: Create the Structuring Element”on page 9-42 


“Step 3: Enhance the Image Contrast” on page 9-42 


“Step 4: Exaggerate the Gaps Between Objects”on page 9-43 


“Step 5: Convert Objects of Interest” on page 9-44 


“Step 6: Detect Intengsity Valleys”on page 9-45 


“Step 7: Watershed Segmentation”on page 9-46 


“Step 8: Extract Features 人 fom Label Matrix”on page 9-47 


Step 1: Read in Images 
Read in the 'afmsurf.tif' image, which is an atomic force microscope image 
of a surface coating. 


afm = imread(' afmsurf .tif ' ) ; 
figure，imshow(afm) ，title(' Surface Image ') ; 





The image contains many objects of different sizes that are touching each 
other. Object detection in an image is an example of image segmentation. To 
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segment touching objects, the Watershed transform is often used. If you view 
an image as a surface, with mountains (high intensity) and valleys (low 
intensity), the Watershed transform finds intensity valleys in an image， 


To get the best result, maximize the contrast ofthe objects of interest to 
minimize thenumber ofvalleys found by the Watershed transform. A common 
technique for contrast enhancement is the combined use of the top-hat and 
bottom-hat transforms. 


The top-hat transform is defined as the difference between the original image 
and its opening. The opening of an image is the collection of foreground parts 
of an image that fit a particular structuring element. The bottom-hat 
transform is defined as the difference between the closing ofthe original image 
and the original image. The closing of an image is the collection of background 
parts of an image that fit a particular structuring element. 


Step 2: Create the Siructuring Element 


Since the objects of interest in our image look like qisks, the example uses the 
strel function to create a disk structuring element. The size ofthe disk is 
based on an estimation of the average radius of the objects in the image. 


Se = Strel('disk' ，15) 


Step 3: Enhance the Image Contrast 
The imtophat and imbothat functions return the top-hat and bottom-hat 
transforms, respectively, ofthe original imasge. 

Itop = imtophat(afm，Se) ; 

Ibot = Imbothat(afm，Se) ; 

figure，imshow(Itop，[])，title(' top-hat image ) ; 
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figure，imshow(Ibot，[])，title( bottom-hat image ') ; 





Step 4: Exaggerate tfhe Gaps Between Objects 


The top-hat image contains the “peaks”of objects that fit the structuring 
element. The imbothat function shows the gaps between the objects. To 
maximize the contrast between the objects and the gaps that separate them 
位 om each other, the example adds thetop-hat imagetothe original image, and 
then subtracts the “bottom-hat”image 位 om the result. The example uses the 
toolbox imasge arithmetic functions, imadd and imsubtract, to perform these 
operations， 
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Ienhance = imsubtract(imadd(Itop，afm) ，Ibot) ; 
figure，imshow(Ienhance), title('original+top-hat - bottom-hat ) ; 





Step 5: Convert Objects of Inferest 


Because the watershed transform detects intensity“valleys”in an image, the 
example uses the imcompIement function on the enhanced image to highlight 
the intengsity valleys. 


Iec = imcomplement(Ienhance ) ; 
figure，imshow(Iec)，tit1le(' complement of enhanced image ) ; 


所 村 
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Step 6: Detect Intensity Valleys 


The example detects all the intensity valleys deeper than aparticular 
threshold with the imextendedmin function. The output ofthe imextendedmin 
fanction is a binary image. The location rather than the size of the regiongs in 
the imextendedmin imnageis imnportant.The imimposemin fanction modifies the 
image to contain only those valleys found by the imextendedmin function. The 
imimposemin fanction also changes a valley's pixel values to zero (deepest 
possible valley for uint8 images). All regions containing an imposed minima 
are detected by the watershed transform. 


Iemin = imextendedmin(Iec，22) ; 
Iimpose = imimposemin(Iec，Iemin) ; 
figure，imshow(Iemin)，title('extended minima image ) ; 





figure，imshow(Iimpose)，title(' imposed minima Image ) ; 
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Step 7: Watershed Segmentation 


Use the watershed function to accomplish Watershed segmentation ofthe 
imnposed minima image. 


wat = Watershed(Iimpose) ; 


The watershed function returns a label matrix containing nonnegative 
numbers that correspond to watershed regions. Pixels that do not fall into any 
watershed region are given a pixel value of 0. 


Agood wayto visualize alabel matrix is to convert 过 to acolor image,using the 
label2rgb fanction. In the color version of the image, each labeled region 
displays in a different color and the pixels that separate the regions display 
white. 


rgb = label2rgb(wat) ; 


figure，imshow(rgb ) ; 
title('watershed Segmented image ) ; 
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Step 8: Extract Features from Label Matrix 


Features can be extracted 他 om the label matrix with the regionprops 
fanction. For example, we can calculate two measurements (area and 
orientation) and view them as a fanction of one another. 


Stats = regionprops(wat， 'Area' ， ' Orientation ' ) ; 
area = [stats.Areal] 

orient = [stats.Orientation]; 
figure，plot(area，orient， "bx* ' ); 

title('` Relationship of Particle Orientation to Area ) ; 
Xlabel(' particle area (pixels) ); 

ylabel(' particle orientation (degrees) ) 
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Relotionship of parficle orientaiion fo orea 


Partidle orientofion (degrees) 





Poriicdle area (pixels) 
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Obiects, Regions, and Feature Measurement 


The toolbox includes several functions that return information about the 
features in a binary image, including: 


e Connected-component labeling, and using the label matrix to get statistics 
about an image 

e Selecting objects in an image 

e Finding the area of a binary image 

se Finding the Euler number of a binary image 


Connected-Component Labeling 


The bwlabel and the bwlabeln functions perform co7z7zecteQ-co7mzpo7ze7zt 
/abel1i7s, which is a method for identifying each object in a binary image. The 
bwlabel function supports 2-D inputs only; the bwlabeln function Supports 
inputs of any dimension , 


These functiongs return a matrix, called a /ape/! at7zx. Alabel matrix is an 
image,the same size as theinput image,in which theobjects in the input image 
are distinguished by different integer values in the output matrix. For 
example, bwlabel can identify the objects in this binary image. 


BW = [0 0 0 0 0 0 0 0 1 
0 1 1 0 0 1 1 1 ; 
0 1 1 0 0 0 1 1 
0 1 1 0 0 0 0 0 1 
0 0 0 1 1 0 0 0 
0 0 0 1 1 0 0 0 
0 0 0 1 1 0 0 0 
0 0 0 0 0 0 0 0] 
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X = bwlabel(BW,4) 


外 
口 口 口 口 一 一 一 口 
口 口 口 口 一 一 一 口 
人 TOO 
DODODODOD 
站 和 人 
人 人 
DOoOooOoODmowmnD 


In the output matrix, the ls represent one object, the 2”s a second object, and 
the 3s athirdq. (Ifyou had used 8-connected neighborhoods (the default), there 
would be onlytwo objects, because the first and second objects would be asingle 
object, connected along the diagonal.) 


Viewing a Label Matrix 


The label matrix returned by bwlabel or bwlabelnis ofclass double; itis not 
a binary image. One way to view it is to display it as a pseudo-color indexed 
image, using label2rgb. In the pseudo-color image, the number that identifies 
each object in the label matrix maps to a different color in the associated 
colormap matrix. When you view a label matrix as an RGB image, the objects 
in the image are eagsier to distingujish. 


To illustrate this technique, this exzample uses labe1l2rgb to view the label 
matrix, X. The call to label2rgb specifies one ofthe standard MATLAB 
colormaps, jet. The third argument，'k', specifies the background color 
(black). 


X = bwlabel(BW1 ,4) ; 
RGB = label2rgb(X，Qjet， ' k' ); 
Imshow(RGB ，notruesize ) 





Obiecfs, Regions, and Feature Measuremeni 








Figure 9-9: Using Color fo Distinguish Obiects in a Binary Image 


Selecting Obiects in a Binary Image 


You can use the bwselect function to select individual objects in a binary 
image. You specify pixels in the input image, and bwselect returns a binary 
image that includes only those objects 他 om the input imagethat contain one of 
the specified pixels. 


You can specify the pixels either noninteractively or with a mouse. For 
example, sSuppose you want to select objects in the image displayed in the 
current axes. You type 


BW2 = bwSselect ; 


The cursor changes to a cross-hair when it is over the image. Click on the 
objects you want to select; bwselect displays a small star over each pixel you 
click on. When you are done, press Return. bwselect returns a binary image 
consisting of the objects you selected, and removes the stars. 


See the reference page for bwselect for more information. 


Finding the Area of Binary Images 

The bwarea function returns the area of abinary image. The area is a measure 
of the size of the foreground of the image. Roughly speaking, the area is the 
number of on pixels in the image. 


bwarea does not Simply count the number of pixels set to on, however. Rather， 
bwarea weights different pixel patterns unequally when computing the area. 
This weighting compensates for the distortion that is inherent in representing 
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a continuous image with discrete pixels. For example, a diagonal line of 50 
pixels is longer than a horizontal line of 50 pixels. As a result ofthe weighting 
bwarea uses, the horizontal line has area of 50, but the diagonal line has area 
of 62.5. 


This example uses bwarea to determine the percentage area increase in 
circbw.tif that results from a dilation operation. 


BW = imread( circbw.tif ) ; 

SE = oneSs(5) 

BW2 = imdilate(BW,SE) ; 

increase = (bwarea(BW2) - bwarea(BW) ) /bwarea(BW) ; 
increase = 


0.3456 


See the reference page for bwarea for more information about the weighting 
pattern. 


Finding the Euler Number of a Binary Image 


The bweuler function returns the Euler number for a binary image. The Euler 
number is a measure of the topology of an image. It is defined as the total 
number ofobjects in the image minus thenumber ofholes in those objects. You 
can use either 4- or 8-connected neighborhoods. 


This example computes the Euler number for the circuit image, using 
8-connected neighborhoods. 

BW1 = imread(' circbw.tif ) ; 

eul = bweuler(BW1 ,8) 


eul 


-85 


In this exzample, the Euler number is negative, indicating that the number of 
holes is greater than the number of objects. 
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Lookup Table Operations 


Certain binary image operations can be implemented most easily through 
lookup tables. A lookup table is a column vector in which each element 
represents the value to return for one possible combination of pixels in a 
neighborhood. 


You can use the makelut function to create lookup tables for various 
operations. makelut creates lookup tables for 2-by-2 and 3-by-3 neighborhoods. 
This fgure illustrates these types ofneighborhoods. 也 ach neighborhood pixel 
is indicated by an X, and the center pixel is the one with a circle. 









































X|X |X 
CG)| x X Oo | x 
X | X 又 | 和 | 入 
2-by-2 neighborhood 3-by-3 neighborhood 


For a 2-by-2 neighborhood, there are 16 possible permutations ofthe pixels in 
theneighborhood. Therefore,the lookup table forthis operation is a 16-element 
vector. For a 3-by-3 neighborhood, there are 512 permutations, so the lookup 
table is a 512-element vector. 


Once you create a lookup table, you can use it to perform the desired operation 
by using the applLyLut fanction. 


The example below illustrates using lookup-table operations to modify an 
image containing text. You begin by writing a function that returns 1 过 three 
or more pixels in the 3-by-3 neighborhood are 1; otherwise, it returns 0. You 
then call makelut,passing in this function as the first argument, and using the 
second argument to specify a 3-by-3 lookup table. 


f= inline(' Sum(x(:)) >= 3 ); 
Lut = makelut(f,3) 


lut is returned as a512-element vector of ls and 0's.Each value is the output 
位 om the function for one ofthe 512 possible permutations, 
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You then perform the operation using app1Ly1lLut. 


BW1 imread( text.tif ' ) ; 
BW2 = applLlylut(BW1 ,Lut) ; 
imshow(BW1 ) 
figure，imshow(BW2 ) 


Cross-Cotrrelation Used Cross-Correlauon Used 
To Locate 入 久 nowWt To Locate 各 Known 
Targetin an Image Target in an |mage 
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Figure 9-10: Texft.fif Before and After Applying a Lookup Table Operation 


For information about how applylut maps pixel combinationgs in the image to 
entries in the lookup table, see the reference page for app1Ly1lLut. 





Notfte You cannot use makelut and applylut for neighborhoods of sizes other 
than 2-by-2 or 3-by-3. These functions Support only 2-by-2 and 3-by-3 
neighborhoods, because lookup tables are not practical for neighborhoods 
larger than 3-by-3. For example, a lookup table for a 4-by-4 neighborhood 
would have 65,536 entries. 
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This section describes the Image Processing Toolbox functions that support arange of standard 
image processing operationgs for analyzing and enhancing images. Topics covered include 


Terminology (p. 10-2) Provides definitions of image processing terms used in 
this section 


Pixel Values and Statistics (p. 10-3) Describes the toolbox functions that return information 
about the data values that make up an image 


Image Analysis (p. 10-10) Describes the toolbox fanctiongs that return information 
about the structure of an image. 


Image Enhancement (p. 10-14) Describes the toolbox functions used to imnprove an image， 
such as adjusting the intengsity or removing noise. 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


Definitions 





Adaptive filter 


Contour 


Edge 


Property 


Histogram 


Noise 


Profile 


Quadtree decomposition 


Atfilter whose properties vary across an image depending on 
the local characteristics of the image pixels. 


Apath in an image along which the image intensity values are 
equal to a constant. 


Acurvethat follows apath ofrapid change in image intensity. 
卫 qges are often associated with the boundaries of objects in a 
Scene. 也 dge detection is used to identify the edges in an 
Image. 


Aquantitative measurement of an image or image region. 
卫 xamples of image region properties include centroid， 
bounding box, and area. 


Agraph used in image analysis that showsgs the distribution of 
intensities in an image. The information in a histogram can be 
used to choose an appropriate enhancement operation. For 
example, 过 an image histogram shows that the range of 
intensity values is small, you can use an intengsity adjustment 
function to Spread the values across a wider range. 


Errors in the image acquisition process that result in pixel 
values that do not reflect the true intensities of the real scene. 


Aset of intensity values taken from regularly spaced points 
along a line segment or multiline path in an image. For points 
that do not fall on the center of a pixel, the intensity values 
are interpolated. 


An image analysis technique that partitions an image into 
homogeneous blocks. 





Pixe| Values and Stafistics 





Pixel Values and Stfafisfics 


The Image Processing Toolbox provides several functiongs that return 
information about the data values that make up an image. These functions 
return information about image data in various forms, including: 


e The data values for selected pixels (pixval, impixe1) 

e The data values along apath in an image (improfile) 

e A contour plot of the image data (imcontour) 

e Ahistogram ofthe image qdqata (imhist) 

e Summary statistics for the image data (mean2, std2, corr2) 
e Feature measurements for image regions (imfeature) 


Pixel Selecftion 


The toolbox includes two functions that provide information about the color 
data values of image pixels you specify: 


e The pixval function interactively displays the data values for pixels as you 
move the cursor over the image. pixval can also display the Euclidean 
distance between two pixels. 


e The impixel function returns the data values for a selected pixel or set of 
pixels. You can Supply the coordinates of the pixels as input arguments, or 
you can Select pixels using a mouse. 


To use pixval, youfirst display an image and then enterthe pixval command. 
pixval installs a black bar atthe bottom ofthe figure, which qisplays the (X,y) 
coordinates for whatever pixel the cursor is currently over, and the color data 
for that pixel. 


HI 节 you click on the image andhold down the mouse button while you move the 
cursor, pixval also displays the Euclidean distance between the point you 
clicked on and the current cursor location. pixval draws a line between these 
points to indicate the distance being measured. When you release the mouse 
button, the line and the distance display qisappear. 


pixval gives you more imnmediate results than impixel, but impixel has the 
advantage ofreturning its results in a variable, and it can be called either 
interactively or noninteractively. Ifyou call impixel with no input arguments， 
the cursor changes to a crosshair when it is over the image. You can then click 
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on the pixels of interest; impixel displays a small star over each pixel you 
select. When you are done selecting pixels, press Return. impixel returns the 
color values for the selected pixels, and the stars disappear. 


In this example, you call impixel and click on three points in the displayed 
image, and then press Return. 


Imshow Canoe .七 ff 
Vvals = ImpIxel 





Vals = 


0.1294 0.1294 0.1294 
0.5176 0 0 
0.7765 0.6118 0.4196 


Notice that the second pixel, which is part of the canoe, is pure redi; its green 
and blue values are both 0. 


For indexed images, pixval and impixel both show the RGB values stored in 
the colormap, not the index values. 


Intensify Profile 


The improfile fanction calculates and plots the intensity values along a line 
segment oramultiline path in an image.Youcan Supplythe coordinates ofthe 


Pixe| Values and Stafistics 





line segments as input arguments, or you can define the desired path using a 
mouse. In either case, improfile uses interpolation to determine the values of 
equally spaced points along the path. (By default, improfile uses nearest 
neighbor interpolation, but you can specify a different method. See Chapter 4， 
“Spatial Transformations”, for a discussion of interpolation.) improfile WorkSs 
best with intensity and RGB imasges. 


For a single line segment, improfile plots the intensity values in a 
two-dimensional view. For a multiline path, improfile plots the intensity 
values in a three-dimensional view. 


开 you call improfile with no arguments, the cursor changes to a cross hair 
whenit is over theimage.You can then specify line segments by clicking on the 
endpoints; improfile draws a line between each two consecutive points you 
select. When you finish specifying the path, press Return. improfile displays 
the plot in a new 和 gure. 


In this example, you call improfile and specify a single line with the mouse. 
The line is shown in red, and is drawn 位 om left to right. 


Imshow debye1.tif 
Improfile 
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improfile displays a plot ofthe data along the line. 
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Figure 10-1: A Plot of Intensity Values Along a Line Segment in an Intensity 
Image 


Notice the peaks and valleys and how they correspond to the light and dark 
bands in the image. 


The example below shows how improfile works with an RGB image. The red 
line indicates where the line selection was made. Note that the line was drawmn 
位 om top to bottom， 


Imshow f1Lowers .七 二 
Improfile 
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The improfile fanction displays a plot with separate lines for the red, green， 
and blue intensities. 
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Figure 10-2: A Plot of Intensity Values Along a Line Segmenti in an RGB Image 
Notice how the lines correspond to the colors in the image. For example, the 


central region ofthe plot shows high intensities ofgreen andred, while the blue 
intensity is 0. These are the values for the yellovw flower. 
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Image Contours 


Youcan use the toolbox function imcontour to display a contour plot ofthe data 
in an intensity image. This function is similar to the contour fanction in 
MATLAB, but it automatically sets up the axes so their orientation and aspect 
ratio match the image. 


This example displays an intengsity image ofgrains ofrice and a contour plot of 
the image data. 


I= imread(' rice.tif ); 
Imshow(I) 
figure，imcontour(I) 




















Figure 10-3: Rice.fif and lts Contour Plof 


You can use the clabel function to label the levels of the contours. See the 
description of clabel in the MATLAB Function Reference for details. 


Image Histogram 


An ;mazase Histosra1m js a chart that shows the distribution of intengsities in an 
indexed or intensity image. The image histogram function imhist creates thigs 
plot bymaking nequally spaced bins, each representing arange of data values. 
It then calculates the number of pixels within each range. For example, the 
commands below display an image of grains of rice, and a histogram based on 
64 bins. 
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I= imnread(' rice.tif ' ); 
Imshow(I) 
figure，imhist(I,64) 





























Figure 10-4，Ricefif and lts Histogram 


The histogram shows a peak at around 100, due to the dark gray background 
in the image. For information about how to modify an image by changing the 
distribution of its histogram, see“Intensity Adjustment”on page 10-14. 


Summary Stafisftics 

You can compute standard statistics of an image using the mean2, std2, and 
corr2 functions. mean2 and std2 compute the mean and standard deviation of 
the elements of a matrix. corr2 computes the correlation coefGcient between 
two matrices of the same size. 


These functiongs are two-dqimensional versions ofthe mean, std, and corrcoef 
functions described in the MATLAB Function Reference. 


Region Property Measurement 

You can use the regionprops function to compute properties for image regions. 
For example, regionprops can measure Such properties as the area, center of 
mass, and bounding box for a region you specify. See the reference page for 
regionprops for more information. 
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Image analysis techniques return information about the structure ofan image. 
This section describes toolbox functiongs that you can use for these image 
analysis techniques: 


e 了 dge detection 
e Quadtree decomposition 


The functions qdqescribed in this section work only with intensity images. 


Edge Detecfion 


You can use the edge function to detect edges, which are those places in an 
image that correspond to object boundaries. To find edges, this function looKks 
for places in the image where the intensity changes rapidly, using one ofthese 
two criteria: 


e Places where the first derivative ofthe intensity is larger in magnitude than 
Some threshold 


e Places where the second derivative of the intensity has a zero crossing 


edge provides anumber ofdqerivative estimators, each ofwhich implements one 
of the definitions above. For some ofthese estimators, you can Specify whether 
the operation should be sengsitive to horizontal or vertical edges, or both. edge 
returngs a binary image containing 1s where edges are found and 0's elsewhere. 


The most powerful edge-detection method that edge provides is the Canny 
method. The Canny method differs ffom the other edge-detection methods in 
that it uses two different thresholdqs (to detect strong and weak edges), and 
includes the weak edges in the output only 这 they are connected to strong 
edges. This method is therefore less likely than the others to be “fooled”by 
noise, and more likely to detect true weak edges. 


The example below illustrates the power of the Canny edge detector. It shows 
the results of applying the Sobel and Canny edge detectors to the rice.tif 
Image. 


I= imread(' rice.tif ); 
BW1 = edge(I，sobel ) 
BW2 = edge(I，canny  ) ; 
imshow(BW1 ) 


Image Analysis 





figure，imshow(BW2 ) 





Sobe| Filter 


Canny Filter 


For an interactive demonstration of edge detection, try running edgedemo. 


Quadtiree Decomposition 


Quadtree decomposition is an analysis technique that involves subdividing an 
image into blocks that are more homogeneous than the image itself This 
technique reveals information about the structure ofthe image. It is alsouseful 
as the first step in adaptive compression algorithms. 


You can perform quadtree decomposition using the qtdecomp function. This 
fanction works by dividing a square image into four equal-sized square blocks， 
and then testing each block to see 让 it meets Some criterion of homogeneity 
(e.g., ifall ofthe pixels in the block are within a specific dynamic range). Ifa 
block meets the criterion, it is not divided any further. I 直 does not meet the 
criterion,it is subdivided again into four blocks, and the test criterion is applied 
to those blocks. This process is repeated iteratively until each block meets the 
criterion. The result may have blocks of several different Sizes. 


For example, suppose you want to perform quadtree decomposition on a 
128-by-128 intensity image. The first step is to divide the image into four 
64-by-64 blocks. You then apply the test criterion to each block; for example， 
the criterion might be 


max(block(:)) min(block(:)) <= 0.2 


If one of the blocks meets this criterion, it is not divided any further; it is 
64-by-64 in the final decomposition. Ifa block does not meet the criterion, it is 
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then divided into four 32-by-32 blocks, and the test is then applied to each of 
these blocks. The blocksthatfailto meetthe criterion are then divided into four 
16-by-16 blocks, and so on, until all blocks“pass.”Some of the blocks may be as 
small as 1-by-1, unless you Specify otherwise. 


The call to qtdecomp for this example would be 
S = qtdecomp(I;,0.2) 


S is returned as a sparse matrix whose nonzero elements represent the 
Upper-left corners ofthe blocks; the value ofeach nonzero element indicates the 
block size. S is the same Size as I. 





Notfte The threshold value is specified as a value between 0 and 1l, regardless 
ofthe classofI.IfiIis uint8, the threshold value you supply is multiplied by 
255 to determine the actual threshold to use; 这 Iis uint16, the threshold 
value you Supply is multiplied by 65535. 





The example below shows an image and a representation of its quadtree 
decomposition. Each black square represents a homogeneous block, and the 
white lines represent the boundaries between blocks. Notice how the blocks are 
smaller in areas corresponding to large changes in intensity in the image. 





Figure 10-5: An Image (left) and a Representation of its Quadtree 
Decomposition 


Image Analysis 





You can also supply qtdecomp with a fanction (rather than a threshold value) 
for deciding whether to split blocks; for example, you might base the decision 
on the variance of the block. See the reference page for qtdecomp for more 
information. 


For an interactive demonstration of quadtree decomposition, try running 
qtdemo. 
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Image enhancement techniques are used to imnprove an image, where 
“improve”is Sometimes defined objectively (e.g., increase the signal-to-noise 
ratio), and sometimes subjectively (e.g., make certain features easier to see by 
modifying the colors or intensities). 


This section discusses these image enhancement techniques: 


e“JIntensity Adjustment” 
e“Noise Removal” 


The functions qdqescribed in this section apply primarily to intensity images. 
However, some of these functions can be applied to color images as well. For 
information about hovw these functions work with color images, see the 
reference pages for the indqividual fanctions. 


Intensity Adiustment 


Intensity adqjustment is a technique for mapping an image's intensity values to 
anewrange.For exzample, rice.tif.is alow contrast imnage. The histogram of 
rice.tif, shown in Figure 10-4, indicates that there are no values below 40 or 
above 225. Ifyou remap the data values to fill the entire intensity range [0， 
255], you can increase the contrast ofthe imasge. 


You can do this kind of adqjustment with the imadjust function. The general 
Syntax of imadjust is 


J= imadjust(I,[LIow_ in high_in],[lLow out high_out]) 
where low_ in and high_in are the intensities in the input image which are 


mapped to low_out and high_out in the output image. For example, this code 
performs the adqjustment qescribed above. 


工 imread( rice.tif ' ) ; 
J = imadjust(I,[0.15 0.9],[0 1]); 


The first vector passed to imadjust, [0.15 0.9], specifies the low and high 
intengsity values that you want to map. The second vector, [0 1], specifies the 
scale over which youwant to map them. Thus, the exzample maps the intengsity 
value 0.15 in the input image to 0 in the output image, and 0.9 to 1. 
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Note that youmust specify the intensities as values between 0 and 1regardless 
ofthe class ofI.IfiIis uint8,the values you Supply are multiplied by 255 to 
determine the actual values to use; ifIis uint16,the values are multiplied by 
65535. To learn about an alternative way to set this limits automatically, see 
“Setting the Adqjustment Limits Automatically”on page 10-16. 


This figure displays the adqjusted image andits histogram. Notice the increased 
contrast in the image, and that the histogram now fills the entire range. 


imshow(J) 
figure，imhist(J,64) 






































Figure 10-6:， Rice.fif After an Intensity Adiustment and a Histogram of lts 
Adiusted Intfensities 


Similarly, you can decrease the contrast ofan image bynarrowing therange of 
the data, as in this cal]. 


J = imadjust(I,[0 1],[0.3 0.8]) 


In addition to increasing or decreasing contrast, youcan perform a wide variety 
of other image enhancements with imadjust. In the example below, the mamn's 
coat is too dark to reveal any detail. The call to imadjust maps therange [0,51] 
in the uint8 input image to [128,255] in the output image. This brightens the 
image considerably, and also widens the dynamic range ofthe dark portions of 
the original image, making it much eagsier to see the details in the coat. Note， 
however, that because all values above 51 in the original image get mapped to 
255 (white) in the adqjusted image, the adjusted image appears“washed out.” 
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I= imread(' cameraman.tif ' ) ; 

J= imadjust(I,[0 0.2],[0.5 1]); 
imshow(I) 

figure，imshow(J ) 





Figure 10-7: Remapping and Widening the Dynamic Range 


Setting the Adiustment Limits Aufomatically 
To use imadjust, you must typically perform two steps: 


1 Vievw the histogram of the image to determine the intengsity value limits. 


2 Specify these limits as a fraction between 0.0 and 1.0 so that you can passg 
them to imadjust in the [low_ in high_in] vector. 


For amore convenient way to specify theselimits, use the stretch1lim fanction， 
This function calculates the histogram of the image and determines the 
adjustment limits automatically. The stretchlim fuanction returns these 
values as factiongs in a vector that you can pass as the [low_ in high_in] 
argument to imadjust; for exzample， 


I= imread(' rice.tif ' ); 
J= imadjust(I,stretchlim(I),[0 1]); 


By default, stretch1lim uses the intengsity values that represent the bottom 19%5 
(0.01) and the top 1% (0.99) ofthe range as the adjustment limits. By trimming 
the extremes atboth ends ofthe intensityrange, stretchlim makes more room 
in the adjusted dynamic range for the remaining intengsities. But you camn 
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specify other range limits as an argument to stretch1lim. See the stretch1lim 
reference page for more information , 


Gamma Correction 


imadjust maps Low to bottom, and high to top. By default, the values between 
LIow and high are mapped linearly to values between bottom and top. 了 For 
example, the value halfway between low and high corresponds to the value 
halfway between bottom and top. 


imadjust can accept an additional argument which specifies the sa7z772a 
coz7ecton factor. Depending on the value of gamma, the mapping between 
values in the input and output images may be nonlinear. For example, the 
value halfway between low and high may map to avalue either greater than 
or less than the value halfway between bottom and top. 


Gamma can be any value between 0 and infinity. If gammais 1 (the default)， 
the mapping is linear. Ifgammais less than 1,the mapping is weighted toward 
higher (brighter) output values. If gamma is greater than 1, the mapping is 
weighted toward lower (darker) output values. 


The figure below illustrates this relationship. The three transformation curvVes 
show how values are mapped when gamma is less than, equal to, and greater 
than 1. (In each graph, the x-axis represents the intensity values in the input 
image, and the y-axis represents the intensity values in the output image.) 


Y<1L Y=1 Y>1 


top top top 


bottom bottom bottom 
0OW high 工 OW high 0OW high 


Figure 10-8: Plots Showing Three Different Gamma Correcfion Settings 


The example below illustrates gamma correction. Notice that in the call to 
imadjust, the data ranges ofthe input and output images are specified as 
empty matrices. When you specify an empty matrix, imadjust uses the default 
range of [0,1. In the example, both ranges are left empty; this means that 
gamma correction is applied without any other adjustment of the data. 
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[X,map] = imread( ' forest.tif ') 
I = ind2gray(X;,map) ; 

J= imadjust(I,[],[];0.5) 
imshow(I) 

figure，imshow(Jy ) 





Figure 10-9: Foresti.tif Before and After Applying Gamma Correcftion of 0.5 


Histogram Equalization 

The process of adqjusting intensity values can be done automatically by the 
histeq fanction. histeq performs Aizstosra7mmz eqalLization，which involves 
transforming the intensity values so that the histogram of the output image 
approximately matches a specified histogram. (By default, histed tries to 
match aflat histogram with 64 bins, but you can specify a different histogram 
instead; see the reference page for histed.) 


This example illustrates using histeqto adjust an intensity image. The 
original imnage has low contrast, with mostvalues in the middqle ofthe intensity 
range. histedq produces an output image having values evenly distributed 
throughout the range. 


I= imread('pout.tif ' ); 
J = histeq(I) ; 
imshow(I) 
figure，imshow(JU ) 


Image Enhancement 








Figure 10-10: Pout.tif Before and After Histogram Equalization 


The example below shows the histograms for the two images. 


figure，imhist(I) 
figure，imhist(J) 
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Figure 10-11: Histogram Before Equalization (leff) and After Equalizaftion (righf) 


histeq can return an additional 1-by-256 vector that shows, for each possible 
input value, the resulting output value. (The values in this vector are in the 
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range [0,1], regardless ofthe class ofthe input image.) You can plot this data 
to get the transformation curve. For example， 


I= imread('pout.tif ' ); 
[J,T] = histedq(I) ; 
figure,plot((0:255)/1255,T) ; 














Notice how this curve reflects the histograms in the previous figure, with the 
input values being mostly between 0.3 and 0.6, while the output values are 
distributed evenly between 0 and 1. 


For an interactive demonstration ofintensity adqjustment, try running 
imadjdemo. 


Noise Removdal 


Digital images are prone to a variety of types of noise. There are Several waysg 
that noise can be introduced into an image, depending on how the image is 
created. For example: 


e Ifthe image is scanned 人 om a photograph made on flm, the flm grain is a 
SoOurce of noise. Noise can also be the result of damage to the film, or be 
introduced by the scanner itself. 


e Ifthe image is acquired directly in a digital format, the mechanism for 
gathering the data (such as a CCD detector) can introduce noise. 


Image Enhoancemenli 





e Electronic transmission of image data can introduce noise. 


The toolbox provides a number of qifferent ways to remove or reduce noise in 
an image. Different methods are better for different kinds ofnoise. The 
methods available include: 


e Linear 下 ltering 
e。 Median filtering 
e Adaptive filtering 


Also, in order to simulate the effects of some of the problems listed above, the 
toolbox provides the imnoise function, which you can use to aqQa various types 
of noise to an image. The examples in this section use this fanction. 


Linear Filtering 


You can use linear filtering to remove certain types of noise. Certain 下 lters， 
Such as averaging or Gaussian filters, are appropriate for this purpose. For 
example, an averaging filter is useful for removing grain noise 位 om a 
photograph. Because each pixel gets set to the average of the pixels in its 
neighborhood, local variations caused by grain are reduced. 


See “Linear Filtering”on page 7-4 for more information 


Median Filtering 

Median filtering is similar to using an averaging filter, in that each output 
pixel is set to an “average”of the pixel values in the neighborhood of the 
corTresponding input pixel. However, with median fltering, the value of an 
output pixel is determined by the eadia7m of the neighborhood pixels, rather 
than the mean. The median is much less sensitive than the mean to extreme 
values (called ovtiers). Median filtering is therefore better able to remove 
these outliers without reducing the sharpness ofthe image. 


The medfilt2 function imnplements median filtering. The example below 
compares using an averaging filter and medfilt2 to remove salt a7Q Pepper 
noise. This type ofnoise consists ofrandom pixels being set to black or white 
(the extremes of the data range). In both cases the size of the neighborhood 
used for filtering is 3-by-3. 


First, read in the image and add noise to it. 


I= imnread(' eight.tif' ) ; 
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J = imnoise(I，Salt & pepper ;0.02) ; 
imshow(I) 
figure，imshow(J ) 





Figure 10-12: Eighti.fif Before and After Adding Salt-and-Pepper Noise 


Novw filter the noisy image and display the results. Notice that medfilt2 doesg 
a better job of removing noise, with less blurring of edges. 


K = filter2(fspecial( average ' ;3) ,JU)/1255 ; 
L = medfilt2(J,[3 3]) 

figure，imshow(K) 

figure，imshow(L) 














Averaging Filter 


Figure 10-13: Noisy Version of Eighti.fif Filtered with Averaging Filter (lef) 
and Median Filter (righf) 
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Median filtering is a specific case oforaer-statzstzc 万/terzzs, also known as ra7 有 
太 iterins. For information about order-statistic filtering, see the reference page 
for the ordfilt2 function. 


Adapfive Filtering 

The wiener2 function applies a Wiener filter (atype oflinear filter) to an imnage 
aQaptiuely, tailoring itselfto the local image variance. Where the variance is 
large, wiener2 performs little smoothing. Where thevariance is small, wiener2 
performs more smoothing. 


This approach often produces better results than linear filtering. The adaptive 
filter is more selective than a comparable linear filter, preserving edges and 
other high frequency parts of an image. In addition, there are no design tasks; 
the wiener2 function handles all preliminary computations, and implements 
thefilter for an inputimage.wiener2,however, does requjire more computation 
time than linear fltering. 


wiener2 works best when the noise is constant-power (white”) additive noise， 
Such as Gaussian noise. The example below applies wiener2 to an image of 
Saturn that has had Gaussian noise added. 


I= imnread(' Saturn.tif ' ) ; 

J = imnoise(I，gaussian' ,0;,0.005) ; 
= Wiener2(J,[5 5]) 

Imshow(J) 

figure，imshow(K) 


天 





Figure 10-14: Noisy Version of Saturn.fif Before and After Adapftive Filtering 
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For an interactive demonstration of 有 ltering to remove noise, try running 
nrfiltdemo. 
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This section describes operations that you can perform on a selected region of an image. Topics 
covered include 


Terminology (p. 11-2) Provides definitions of image processing terms used in 
this section 


Specifying a Region of Interest (p. 11-3) Describes hovw to specify a region of interest using the 
roipoly function 


Filtering a Region (p. 11-6) Describes hovw to apply a filter to a region using the 
roifilt2 function 


Filling a Region (p. 11-8) Describes how to fill a region of interest using the 
roifil1l fanction 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms Definitions 





Binary mask Abinary image with the same Size as the image you want to 
process. The mask contaings ls for all pixels that are part of 
the region of interest, and 0's everywhere else. 


Filling a region A process that “il1s”a region of interest by interpolating the 
pixel values 位 om the bordqers of the region. This process can 
be used to make objects in an image seem to disappear as they 
are replaced with values that blend in with the background 
area. 


Filtering a region The process of applying a filter to a region of interest. For 
example, you can apply an intensity adjustment filter to 
certain regions of an image. 


Interpolation The process by which we estimate an image value at a location 
in between image pixels. 


Masked filtering An operation that applies filtering only to the regiongs of 
interest in an image that are identified by a binary masK. 
Filtered values are returned for pixels where the binary mask 
contaings 1”s; unfiltered values are returned for pixels where 
the binary mask contaings 0?S. 


Region of interesf A portion of an image that you want to filter or perform some 
other operation on. You define a region of interest by creating 
abinary mask. There can be more than one region defined in 
an image. The regions can be“geographic” in nature, Such as 
polygons that encompass contiguous pixels, or they can be 
defined by arange of intensities. In the latter case, the pixels 
are not necessarily contiguous， 
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Specifying a Region of Interest 


Aresiomn of interest js a portion of an image that you want to filter or perform 
Some other operation on. You define a region of interest by creating a pz7za7y 
170sp, which is a binary image with the same Size as the image you want to 
process. The mask contaings 1;s for all pixels that are part of the region of 
interest, and 0'S everywhere else. 


The following subsections discuss methods for creating binary masks: 


e“Selecting a Polygon”on page 11-3 


e“Other Selection Methods”on page 11-4 (using any binary mask or the 
roicolor function) 


For an interactive demonstration ofregion-based processing, try running 
roidemo. 


Selecting a Polygon 


You can use the roipoly function to specify a polygonal region of interest. 工 
you call roipoly with no input arguments, the cursor changes to a cross hair 
when it is over the image displayed in the current axes. You can then specify 
the vertices of the polygon by clicking on points in the image with the mouse， 
When you are done selecting vertices, press Return; roipoly returns abinary 
image ofthe same size as the input image, containing 1s inside the specified 
polygon, and 0's everywhere else. 


The example below illustrates using the interactive syntax of roipoly to create 
a binary mask. The border of the selected region in Figure 11-1, which was 
created using a mouse, is shown in red. 


II = imnread(' pout.tif ' ) ; 
Imshow(I) 
BW = roipoly 
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Figure 11-1: A Polygonal Region of Interest Selected Using roipoly 


Imshow(BW) 





Figure 11-2: A Binary Mask Creafted for the Region Shown in Figure 11-1. 


You can also use roipoly noninteractively. See the reference page for roipoly 
for more information. 


Other Selection Methods 

roipoly provides an easy way to create a binary mask. However, you can Use 
a1zy binary image as a mask, provided that the binary imasge is the same Size 
as the image being filtered. 


Specifying aq Region of Interesi 





For example, suppose you want to filter the intengsity image I, 和 ltering only 
those pixels whose values are greater than 0.5. You can create the appropriate 
mask with this command. 


BW = (I > 0.5); 
You can also use the roicolor function to define the region ofinterest based on 


a color or intengsity range. For more information, see the reference page for 
roicolor. 
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Filtering a Region 


Youcan usethe roifilt2 function to process aregion ofinterest. When youcall 
roifilt2,you specify an intensity image, abinary mask, andafilter. roifilt2 
filters the input image and returns an image that consists of 有 ltered values for 
pixels where the binary mask contaings 1s, and unfiltered values for pixels 
where the binary mask contaings 0's. This type of operation is called aspeq 
万 [terz705. 


This example uses the mask created in the example in “Selecting a Polygon”on 
page 11-3 to increase the contrast ofthe logo on the girls coat. 


h = fspecial( unsharp ) ; 
I2 = roifilt2(h,I,BW) ; 
imshow(I) 
figure，imshow(I2) 





Figure 11-3: An Image Before and After Using an Unsharp Filter on the 
Region of Interest. 


roifilt2 also enables youto specify your own function to operate on the region 
of interest. In the example below,the imadjust function is used to lighten parts 
of an image. The mask in the example is a binary image containing text. The 
resulting image has the text imprinted on 让 . 


BW = imread( 'text.tif ' ) ; 

I= imread(' cameraman.tif' ) ; 

f= inline('imadjust(x,[],[];0.3) ); 
I2 = roifilt2(I,BW,f) ; 


Filtering oa Region 





Imshow(I2 ) 





Figure 11-4: An Image Brightened Using aq Binary Mask Containing Text 


Note that roifilt2 is best suited to operations that return data in the same 
range as in the original image because the output image takes some of its data 
directly 他 om the input image. Certain fltering operationgs can result in values 
outside the normal image data range (ie., [0,1] for images of class double， 
[0,255] for images of class uint8, [0,65535] for images of class uint16). For 
more information, see the reference page for roifilt2. 
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Filling a Region 


You can use the roifil1l function to]] aregion ofinterest, interpolating 位 om 
the borders of the region. This function is useful for image editing, including 
removal of extraneous details or artifacts. 


roifil1 performs the 玫 ]] operation using an interpolation method based on 
Laplace's equation. This method results in the smoothest possible fill, given the 
values on the boundary of the region. 


As with roipoly, you select the region of interest with the mouse. When you 
complete the selection, roifillreturns animage withthe selectedregion 有 lled 
in， 


This example uses roifillto modify the trees image. The border of the 
selected region is shown in red on the original image. 


1oad trees 

I = ind2gray(X;,map) ; 
imshow(I) 

I2 = Proifil1; 





Figure 11-5: A Region of Interest Selected for Filling 


imshow(I2) 


Filling oa Region 








Figure 11-6: The Region of Interest Shown in Figure 11-5 Has Been Filled 
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Image Deblurring 





This section describes hovw to deblur an image using the toolbox deblurring functions. Topics covered 
include 


Terminology (Pp. 12-2) Provides definitions of image processing terms used in 
this section 


Understanding Deblurring (p. 12-3) Defines deblurring and deconvolution 


Using the Deblurring Functions Provides step-by-step examples of using deconvwnr， 
(p. 12-5) deconvreg, deconvlucy and deconvb1ind functions 


Avoiding Ringing in Deblurred Images Describes how to use the edgetaper function to avoid 
(p. 12-20) “inging”in deblurred images 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


MATLAB Definition 





Deconvoluftion 


Distorftion operator 


Optical transfer funcfion 
(OTF) 


Point spread function 
(PSF) 


The process of reversing the effect of 
convolution . 


The operator that describes a procegSS 
causing the acquired image to be different 
位 om the original scene. Distortion caused by 
a Point Spread Function (see below) is just 
one type of distortion. 


In the frequency domain, the OTF describes 
the response of a linear, position invariant 
System to an impulse. The OTF is the 
Fourier transform of the point spread 
fanction (PSF). 


In the spatial domain, the PSF describes the 
degree to which an optical system blurs 
(Spreads) a point of light. The PSF is the 
inverse Fourier transform of the OTTF. 





Understanding Deblurring 





Understanding Deblurring 


This section provides some background on deblurring techniques. The section 
includes these topics: 

e“Causes of Blurring” 

e“Deblurring Model” 


Causes of Blurring 

The blurring, or degradation, of an image can be caused by many factors: 

e Movement during the image capture process, by the camera or, when long 
exposure times are used, by the subject 


e Out-of-focus optics, use of a wide-angle lens, atmospheric turbulence, or a 
short exzposure time, which reduced the number ofphotons captured 


e Scattered light distortion in confocal microscopy 


Deblurring Model 
Ablurred or degraded image can be approximately described by this equation 
g = Hf + mn, where: 

g = The blurred image 


也 =The distortion operator, also calledthe pozPzt-spreaa jpcetiomz (PSI).This 
function, when convolved with the image, creates the distortion 


f = The original true image 


n=Additive noise, introduced during image acquisition, that corrupts the 
Image 





Note The image freally doesn't exist. This image represents what you would 
have 计 you had perfect image acquisition conditions. 





The Importance of the PSF 


Based on this model, the fandamental task of deblurring is to deconvolve the 
blurred image with the PSF that exactly describes the distortion . 
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Notfte The quality ofthe deblurred image is mainly determined by knowledge 
of the PSEF 





To illustrate, this example takes a clear image and deliberately blurs it by 
convolving it with a PSF. The example uses the fspecial fanction to create a 
PSF that simulates a motion blur, specifying the length ofthe blur in pixels， 
(LEN=31), and the angle of the blur in qdqegrees (THETA=11). Once the PSF is 
created, the example uses the imfilter function to convolve the PSF with the 
original image, IT, to create the blurred image, BlLurred. (To see how deblurring 
is the reverse of this process, using the same images, see“Deblurring with the 
Wiener Filter” on page 12-6.) 


工 imread( flowers.tif ' ) ; 
工 I(10+[1:256] ,222+[1:256],:); 55 Crop the image 
figure;iimshow(I) ;title(' original Image ); 


LEN = 31; 

THETA = 11; 

PSF = fspecial('motion' ,LEN,THETA) ; 

BJlurred = imfilter(I,PSF，circular ，conv ) 
figure; imshow(Blurred) ;title(' Blurred Image ' ) ; 





0riginal image Blurred image 
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Using the Deblurring Funcfions 


The toolbox includes four deblurring functions, listed here in order of 
complexity: 


e deconvwnr 一 Imnplements deblurring using the Wiener 在]ter 
se deconvreg 一 Imnplements deblurring using a regularized filter 
e deconvlucy 一 Imnplements deblurring using the Lucy-Richardson algorithm 


se deconvb1lind 一 Implements deblurring using the blind deconvolution 
algorithm 


All the functions accept aPSF and the blurred image as their primary 
arguments. The deconvwnr function implements a least squares solution. The 
deconvreg fanction implements a constrained least squares solution， where 
you can place constraints on the output imasge (the smoothness requirement is 
the default). With either of these functions, you should provide some 
information about the noise to reduce possible noise amplification during 
deblurring. 


The deconvlucy function imnplements an accelerated, damped 
Lucy-Richardson algorithm. This function performs multiple iterations, using 
optimization techniques and Poisson statistics. With this fonction, you do not 
need to provide information about the additive noise in the corrupted image. 


The deconvblind function imnplements the blind deconvolution algorithm， 
which performs deblurring without knowledge ofthe PSF. When you call 
deconvb1lind, you pass as an argument your initial guess at the PSF. The 
deconvb1lind function returns arestored PSF in addition to the restored image. 
The imnplementation uses the same damping and iterative model as the 
deconvlucy function. 





Nofte You may need to perform many iterations of the deblurring process， 
varying the parameters you specify to the deblurring functions with each 
iteration, until you achieve an image that, based on the limits ofyour7 
information, is the best approximation of the original scene. Along the way 
you must make numerous judgements about whether newly uncovered 
features in the image are features of the original scene, or simply artifacts of 
the deblurring process. 
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For information about creating your own deblurring functions, see“Creating 
Your Own Deblurring Functions”on page 12-19. To avoid “ringing”in a 
deblurred image, you can use the edgetaper function to preprocess your image 
before passing it to the deblurring functions. See“Avoiding Ringing in 
Deblurred Images”on page 12-20 for more information. 


Deblurring with fthe Wiener Filter 


Use the deconvwnr function to deblur an image using the Wiener filter. Wiener 
deconvolution can be used effectively when the frequency characteristics ofthe 
image and additive noise are known, to at least some degree. In the absence of 
nolise, the Wiener 和 filter reduces to the ideal inverse lter. 


This example deblurs the blurred flower image, created in “Deblurring Mode]” 
on page 12-3, specifying the same PSF function that was used to create the 
blur. 


I= imread('flowers.tif ) ; 
工 I(10+[1:256],222+[1:256],:); 5 Crop the image 
figure;iimshow(I) ;title(' Original Image ) ; 


s%5 Create PSF 

LEN = 31; 

THETA = 11; 

PSF = fspecial( motion' ,LEN,THETA) ; 


%5 blur the image 
Blurred = imfilter(I,PSF，circular ，conv ) 
figure; imshow(Blurred) ;title(' Blurred Image ' ) ; 


55 deblur the image 

wnr1l = deconvwnr(BLurred,PSF ) ; 
figure;imshow(wnr1T ) ; 

title(' Restored，True PSF ) ; 
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0riginal image Blurred image Image restored by Wiener filier 


This example jllustrates the imnportance of knowing the PSF, the function that 
caused the blur. When you know the exact PSF, as in this example, the results 
of deblurring can be quite effective. 


Refining fhe Result 


You can affect the deconvolution results by providing values for the optional 
arguments Supported by the deconvwnr function. Using these arguments you 
can Specify the noise-to-signal power value and/or provide autocorrelation 
fanctions to help refine the result of deblurring. To see the impact of these 
optional arguments, view the Image Processing Toolbox Deblurring Demos. 
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Deblurring with a Regularized Filfer 

Use the deconvreg function to deblur an image using aregularized 玫 lter. A 
regularized filter can be used effectively when limited information is known 
about the additive noise. 


Toillustrate,this exzample simulates ablurred image by convolving a Gaussian 
flter PSF with an image (using imfilter). Additive noise in the image is 
Simulated by adding Gaussian noise of variance V to the blurred image (using 
imnoise). 


I= imnread( tissue1.tif ' ) ; 
工 = I(350+[1:256],1:256,:); 
figure;iimshow(I) ;title(' original Image ) 


% Create the PSF 
PSF = fspecial('gaussian' ,11,5) ; 


%5 BlLur the image 
BJlurred = imfilter(I,PSF，conv ) | 


% Add noise 

= .02 

BJurredNoisy = imnoise(Blurred，gaussian ,0,V) 
figure;iimshow(BLurredNoisy) ;title(' Blurred & Nolisy ) 


一 





0rigina|l image Blurred & noisy image 


Use deconvreg to deblur the image, specifying the PSF used to create the blur， 
and the noise-to-signal power ratio, NP. 


Using the Deblurring Funcfions 





NP = Vx*prod(Size(I)); 点 noise power 
[reg1 LAGRA] = deconvreg(BlLurredNoisy ,PSF,NP) ; 
figure,imshow(reg1),title(' Restored with NP ) ; 





Restored image 


Refining fhe Result 


You can affect the deconvolution results by providing values for the optional 
arguments Supported by the deconvreg function. Using these arguments you 
can Specify the noise power value, the range over which deconvreg should 
iterate as it converges on the optimal solution, and the regularization operator 
to constrain the deconvolution. To see the imnpact ofthese optional arguments， 
View the Image Processing Toolbox Deblurring Demos, 


Deblurring with the Lucy-Richardson Algorithm 


Use the deconvlucy function to deblur an image using the accelerated， 
damped, Lucy-Richardson algorithm. The algorithm maximizes the likelihood 
that the resulting image, when convolved with the PSF, is an instance of the 
blurred image, assuming Poisson noise statistics. This function can be effective 
when you know the PSF, but know little about the additive noise in the image. 


The deconvlucy function implements several adaptations to the original 
Lucy-Richardson maximum likelihood algorithm which address complex imasge 
restoration tasks. Using these adaptations, you cani: 

e Reduce the effect of noise amplification on image restoration 

e Account for nonuniform image quality (e.g., bad pixels, flat-field variation) 
e。 Handle camera read-out and background noise 
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es。 Improve the restored image resolution by subsampling 


The following sections provide more information about each of these 
adaptations. 


Reducing fhe Effect of Noise Amplification 


Aoise a11aDLiFcation is acommon problem ofmaximum likelihood methods that 
attempt to fit data as closely as possible. After many iterations, the restored 
image can have a speckled appearance, especially for a smooth object observed 
atlow signal-to-noiseratios. These speckles do not represent any real structure 
in the image, but are artifacts of fitting the noise in the image too closely. 


To control noise amplification, the deconvlucy function uses a damping 
parameter, DAMPAR. This parameter specifies the threshold level for the 
deviation ofthe resulting image from the original image, below which damping 
occurs. For pixels that deviate in the vicinity oftheir original value, iterationgs 
are SUppressed. 


Damping is also used to reduce 7z7sins, the appearance of high-frequency 
structures in a restored image. Ringing is not necessarily the result ofnoise 
amplification. See“Avoiding Ringing in Deblurred Images”on page 12-20 for 
more information. 


Accounting for Nonuniform Image Quality 


Another complication ofreal-life image restoration is that the data might 
include bad pixels, or that the quality ofthe receiving pixels might vary with 
time and position. By specifying the WEIGHT array parameter with the 
deconvlucy function, you can specify that certain pixels in the image be 
ignored. To ignore a pixel, assign a weight of zero to the element in the WEIGHT 
array that corresponds to the pixel in the image. 


The algorithm converges on predicted values for the bad pixels based on the 
information from neighborhood pixels. The variation in the detector response 
位 om pixel to pixel (the so-calledflat-field correction) can also be accommodated 
bythe WEIGHT array. Instead ofassigning a weight of 1.0 to the good pixels, you 
can Specify fractional values and weight the pixels according to the amount of 
the flat-feld correction , 
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Handling Camera Read-Out Noise 
Noise in charge coupled device (CCD) detectors has two primary components: 


se Photon counting noise with a Poisson distribution 
e。 Read-out noise with a Gaussian distribution 


The Lucy-Richardson iterations intrinsically account for the first type ofnoise, 
You must account for the second type of noise; otherwise, it may cause pixels 
with low levels of incident photons to have negative values. 


The deconvlucy function uses the READOUT input parameter to handle camera 
read-out noise. The value ofthis parameter is typically the sum ofthe read-out 
noise variance and the background noise (e.g., number of counts from the 
background radiation.) The value ofthe READOUT parameter specifies an offset 
that ensures that all values are positive. 


Handling Undersampled Images 

The restoration ofundersampled data can be improved significantlyifit is done 
on afiner grid. The deconvlucy function uses the SUBSMPL parameter to specify 
the subsampling rate, ifthe PSF is known to have a higher resolution 


Ifthe undersampled data is the result of camera pixel binning during image 
acquisition, the PSF observed at each pixel rate would serve as a finer grid 
PSF. Otherwise, the PSF could be obtained via observations taken at Subpixel 
offsets or via optical modeling techniques. This method is especially effective 
for the images of stars (high signal-to-noise ratio), because the stars are 
effectively forced to be in the center of a pixel. If a star is centered between the 
pixels, it will be restored as a combination of the neighboring pixels. A finer 
grid would redirect the consequent spreading ofthe starfluxback to the center 
of the star's image， 
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Creating a Sample Blurred Image 

To illustrate a simple use of deconvlucy, this example simulates a blurred， 
noisy image by convolving a Gaussian filter PSF with an image (using 
imfilter) and then adding Gaussian noise of variance V to the blurred image 
(using imnoise). 


I imread(' board .tif ) ; 
工 I(50+[1:256],2+[1:256]，:); 
figure;iimshow(I) ;title(' original Image ) ; 


s%5 Create the PSF 
PSF = fspecial('gaussian',5,5) 


5 Simulate the blLur 
BJlurred = Imfilter(I,PSF，Symmetric' ，conv ' ) 


%5 Add noise 
V = .002; 

BlurredNoisy = imnoise(Blurred，gaussian' ,0,V) 
figure;iimshow(BlurredNoiSsy) ititle(' Blurred & NoiSsy ) ; 


站 Na 


W1-EONFTG: 
型 I7Z0, IRQ,RRM 
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280，3,D000D 
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0riginal image Blurred & noisy image 


Deblurring the Image 

Use deconvlucy to restore the blurred and noisy image, specifying the PSF 
used to create the blur, and limiting the number of iterations to 5 (the default 
is 10). 


Using the Deblurring Functions 








Nofte The deconvlucy function can return values in the output image that 
are beyond the range of the input image. 





luc1 = deconvlucy(BlLurredNoisy,PSF,5) ; 
figure;j imshow(1Luc1 ) ; 
title('Restored Image，NUMIT = 5'); 





Refining fhe Result 


The deconvlucy function, by default, performs multiple iterations of the 
deblurring process. You can stop the processing, after a certain number of 
iterations, to check the result, and then restart the iterations 位 om the point 
where processing stopped. To do this, pass in the input image as a cell arTay， 
for example, {BlurredNoisy}. The deconvlucy function returns the output 
image as a cell array which you can then pass as an input argument to 
deconvlucy to restart the dqeconvolution . 


The output cell array contains these four elements: 
e output{1} 一 The original input image 
e output{2} 一 The image produced by the last iteration 


e output{3} 一 The image produced by the next-to-last iteration 


e output{4} 一 Internal information used by deconvlucy to know where to 
restart the procesSs 
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The deconvlucy function Supports several other optional arguments you can 
use to achieve the best possible result, such as specifying a damping parameter 
to handle additive noise in the blurred image. To see the impact ofthese 
optional arguments, View the Image Processing Toolbox Deblurring Demos. 


Deblurring with the Blind Deconvoluftion Algorithm 


Usethe deconvblind function to deblur an image using theblind deconvolution 
algorithm. The algorithm maximizes the likelihood that the resulting image， 
when convolved with the resulting PSF, is an instance of the blurred image， 
assuming Poisson noise statistics. The blind deconvolution algorithm can be 
used effectively when no information about the distortion (blurring and noise) 
is known. The deconvb1lind function restores the image and the PSF 
Simultaneously, using an iterative procesgs Similar to the accelerated, damped 
Lucy-Richardson algorithm 


The deconvb1lind function, just like the deconvlucy function, implements 
Several adaptations to the original Lucy-Richardson maximum likelihood 
algorithm, which address complex image restoration tasks. Using these 
adaptations, you camn: 


e Reduce the effect ofnoise on the restoration 

se Account for nonuniform image quality (e.g., bad pixels) 

e Handle camera read-out noise 

For more information about these adaptations, see“Deblurring with the 
Lucy-Richardson Algorithm”on page 12-9. In addition, the deconvb1lind 


fonction Supports PSF constraints that can be passed in through a 
user-Specified fanction， 


Creating a Sample Blurred Image 


To illustrate blind deconvolution, this example simulates a blurred image by 
convolving a motion filter PSF with an image (using imfilter). 


I= imread('cameraman.tif ) ; 
figure; imshow(I); title(' original Image ) ; 


PSF = fspecial( motion' ,13,45) ;5 Create the PSF 
figure; imshow(PSF,[]); title(' True PSF ' ) ; 


Blurred = imfilter(I,PSF，circ'，conv ' ); 移 Simulate the blLur 
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figure;j imshow(BLurred); title(' Blurred Image ) ; 











0riginal image 0riginal PSF Blurred image 


Image Restorafion: First Pass 

As a first pass at restoring the blurred image ofthe cameraman, call the 
deconvb1lind function specifying the image and an initial guess at the PSF as 
arguments. 


When you specify the PSF, you must estimate its size and the values t 
contains. Your guess at the size of the initial PSF is more important to the 
Ultimate Success of the restoration than the values in the PSF. To determine 
the size, examine the blurred imnage and measure the width ofa blur (in pixels) 
around an obviously sharp object. For example, in the sample blurred imasge， 
you can measure the blur near the contour of the man”s sleeve. Because youT 
initial guess at the values in the PSF is less important than the size, you cam 
typically specify an array of 1s as the initial PSF. 


The following example showsgs a restoration where the initial guess at the PS 
is the same Size as the true PSF that caused the blur. 


INITPSF = ones(Size(PSF) ) ; 

[J P]= deconvb1lind(Blurred,INITPSF ,30) ; 

figurej imshow(J); title(' Preliminary Restoration ' ) ; 
figurej imshow(P,[]，notrueslize ) |; 
title('Preliminary Restoration ) ; 
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Resiored image Restored PSF 


This example specified an initial PSF that was the same Size as the true PSF， 
ji.e., the PSF used to create the blur. In a real application, you may need to 
rerun deconvb1ind, exzperimenting with PSFs of qifferent sizes, until you 
achieve a satisfactory result. The restored PSF returned by each deconvolution 
can also provide valuable hints at the optimal PSF size. See the Image 
Processing Toolbox Deblurring Demos for an example. 


Image Restoration: Second Pass 


Although the first pass did succeed in deblurring the image to some extent, the 
ringing in the restored image around the sharp intensity contrast areasg ig 
unsatisfactory. (The example deliberately eliminated edge-related ringing by 
usingthe 'circular' optionin imfilter while creating ablurred image.) This 
example makes a second pass at deblurring, this time achieving a better result 
by using both the optional WEIGHT array parameter and by refining the guess 
at the initial PSFE,，P1. 


Creating a WEIGHT Array，To reduce this contrast-related ringing, rerun the 
deconvolution, this time using the optional WEIGHT array parameter to exclude 
areags of high-contrast from the deblurring operation. You exclude a pixel from 
processing by assigning the value 0 to the corresponding element in the WEIGHT 
arTay. (See“Accounting for Nonuniform Image Quality”on page 12-10 for 
information about WEIGHT arrays.) 


This example uses edge detection and morphological processing to create a 
WEIGHT array. The edge, strel, and imdilate fanctions detect the 
high-contrast areas in the image. Because the blur in the image is linear, the 
example dilates the image twice. (For more information about using these 
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fanctions, see Chapter 9,“Morphological Operations.”) To exclude the image 
boundary pixels (a high-contrast area) 位 om processing, the example uses 
padarray to assign the value 0 to all border pixels, 


WEIGHT = edge(I，Ssobel1 ，.28) ; 

Se1 = Strel('disk' ,1); 

Se2 = Strel('1ine' ,13,45) ; 

WEIGHT = ~imdilate(WEIGHT,[se1 Se2]) ; 

WEIGHT = padarray(WEIGHT([1:2 end-[0:1]],[1:2 end-[0:1]]),[2 2]); 
figure; imshow(WEIGHT); title( Weight array ) ; 





Weight orray 


Consiraining the Restored PSF Before repeating the deconvolution with the WEIGHT 
array, the example refines the guess at the PSF. The reconstructed PSF,，P， 
returned by the first pass at deconvolution shows a clear linearity (see the 
image ofthe Restored PSF in “Image Restoration: First Pass”on page 12-15). 
For the second pass, the example uses a new PSF, P1, which is same as the 
restored PSFE but with the small amplitude pixels set to 0. 


P1 = Pi 

P1(find(P1 < 0.01) )=0; 

[J2 P2] = deconvb1lind(Blurred,P1,50,[],WEIGHT ) ; 
figure; imshow(J2) ; 

title('Newly deblurred image ) ; 

figure; imshow(P2,[]，notrueslize ') ; 
title('Newly reconstructed PSF  ) ; 


12-17 


12 Image Deblurring 








Wewly deblurred image Newly reconsiructed PSF 





Refining the Resuli 

The deconvb1lind function, by default, performs multiple iterations of the 
deblurring process. You can Stop the processing, after a certain number of 
iterations, to check the result, and then restart the iterations 位 om the point 
Where processing stopped. To use this feature, you must pass in both the 
blurred image and the PSF as cell arrays, for example, {BLurredl and 
{INITPSF}. 


The deconvb1lind function returns the output image and the restored PSF as 
cell arrays. The output image cell array contains these four elements: 
output{1l 一 The original input image 
output{2} 一 The image produced by the last iteration 
output{3} 一 The image produced by the next-to-last iteration 


output{4} 一 Internal information used by deconvb1lind to know where to 
restart the procesS 


The PSF output cell array contains similar elements. 


The deconvb1lind function supports several other optional arguments you can 
use to achieve the best possible result, such as specifying a damping parameter 
to handle additive noise in the blurred image. To see the imnpact ofthese 
optional arguments, as well as the functional option that allows you to place 
additional constraints on the PSF reconstruction, see the Image Processing 
Toolbox Deblurring Demos. 
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Creating Your Own Deblurring Funcftions 


All the toolbox deblurring functions perform deconvolution in the 位 equency 
domain, where the process becomes a simple matrix multiplication. To work in 
the frequency domain, the deblurring functions must convert the PSF you 
provide into an optical transfer function (OTEF), using the psf2otf function. 
The toolbox also provides a function to convert an OTKF into a PSF, otf2psf. 
The toolbox makes these fanctions available in case you want to create youT 
own deblurring functions. (In addition, to aid this conversion between PSFs 
and OTFs, the toolbox also makes the padding function, padarray, available.) 
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Avoiding Ringing in Deblurred Images 


The Discrete Fourier Transform (DFT), used by the deblurring functions， 
assumes that the frequency pattern of an image is periodic. This assumption 
creates a high-frequency drop-off at the edges of images. In the figure, the 
shaded area represents the actual extent of the image; the unshaded area 
represents the assumed periodicity. 


人 
出 igh-frequency drop-of 
ee 














Image Assumed periodic repetition ii image 


This high-frequency drop-off can create an effect called povPpaary relateqg 
7772S17S in deblurred images. In this fgure, note the horizontal and vertical 
patterns in the imasge. 





To avoid ringing, use the edgetaper function to preprocess your images before 
passing them to the deblurring functions. The edgetaper function removes the 
high-frequency drop-off at the edge of an image by blurring the entire image 
and then replacing the center pixels ofthe blurred image with the original 
image. In this way, the edges ofthe image taper off to a lower frequency. 
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This section describes the toolbox fanctions that help you work with color image data. Note that 
“color”includes shades of gray; therefore much of the discussion in this chapter applies to grayscale 
images as well as color images. Topics covered include 


Terminology (p. 13-2) Provides definitions of image processing terms used in 
this section 

Working with Different Screen Bit Describes hovw to determine the screen bit depth of your 

Depths (p. 13-3) system and provides recommendations 让 you can change 
the bit depth 

Reducing the Number of Colors in an ”Describes how to use imapprox and rgb2ind to reduce the 

JImage (p. 13-6) number of colors in an image, including information 
about qithering 

Converting to Other Color Spaces Defines the concept of image color space and describes 


(p. 13-15) how to convert images between color Spacesg 
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Terminology 


An understanding ofthe following terms will help you to use this chapter. 





Terms 


Definifions 





APpproximaftion 


Indexed image 


Intensity image 


RGB image 


Screen bif depth 


Screen color resolution 


The method by which the software chooses replacement colors in the 
event that direct matches cannot be found. The methods of 
approximation discussed in this chapter are colormap mapping， 
uniform quantization, and minimum variance quantization， 


An image whose pixel values are direct indices into an RGB 
colormap. In MATLAB, an indexed imasge is represented by an arTray 
of class uint8, uint16, or doub1e. The colormap is always an m-by-3 
arTray of class doub1e. We often use the variable name X to represent 
an indexed image in memory and map to represent the colormap， 


An image consisting of intensity (grayscale) values. In MATLAB， 
intengsity images are represented by an array of class uint8, uint16， 
or doub1e. While intensity images are not stored with colormaps， 
MATLAB uses a system colormap to display them. We often use the 
variable name I to represent an intengsity imnage in memory. This 
term is synonymous with the term Srayscale. 


An image in which each pixel is specified by three values 一 one 
each for the red, blue, and green components of the pixels color In 
MATLAB, an RGB image is represented by an m-by-n-by-3 array of 
class uint8, uint16, or doub1e. We often use the variable name RGB 
to represent an RGB image in memory. 


The number of bits per Screen pixel. 


The number of distinct colors that can be produced by the screen 
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Working with Different Screen Bif Depths 


Most computer displays use 8, 16, or 24 bits per Screen pixel. The number of 
bits per Screen pixel determines the display”s screem bit dep 妃 . The screen bit 
depth determines the scree7z color resoLu 万 ol, which is how many dqistinct colors 
the display can produce. 


Regardless ofthe number ofcolors your system can display, MATLAB can store 
and process images with veryhigh bit depths: 224 colors for uint8 RGB images， 
248 colors for uint16 RGB images, and 2159 for double RGB images. These 
images display best on systems with 24-bit color, but usually look fine on 16-bit 
Systems as well. (For additional information about how MATLAB handles 
color, see the MATLAB graphics documentation .) 


This section: 


e Describes hovw to determine your System?s Screen bit depth 
e Provides guidelines for choosing a Screen bit depth 


Determining Your Systems Screen Bif Depth 


To determine your System's Screen bit depth, enter this command at the 
MATLAB promPpt. 


get(0，ScreenDepth  ) 
ans = 


16 
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The integer MATLAB returns represents the number of bits per Screen pixel; 





Value Screen Bif Depth 





8 8-bit displays Supports 256 colors. An 8-bit display can produce 
any of the colors available on a 24-bit display, but only 256 
distinct colors can appear at one time. (There are 256 shades of 
gray available, but ifall 256 shades of gray are used, they take 
up all ofthe available color slots.) 


16 16-bit displays usually use 5 bits for each color component， 
resulting in 32 (i.e.， 25) levels each of red， green, and blue. This 
supports 32,768 (ie., 215) distinct colors (of which 32 are shadesg 
of gray). Some systems use the extra bit to increase the number 
of levels of green that can be displayed. In this case, the number 
of different colors Supported by a 16-bit display is actually 
64,536 (i.e. 216). 


24 24-bit displays use 8 bits for each of the three color components， 
resulting in 256 (i.e.， 28) levels each of red， green, and blue. This 
SUpports 16,777,216 (i.e.， 224) different colors. (Of these colors， 
256 are shades of gray. Shades of gray occur where R=G=B.) The 
16 million possible colors supported by 24-bit display can render 
alife-like imasge. 


32 32-bit displays use 24 bits to store color information and use the 
remaining 8 bits to store transparency data (alpha channel). For 
information about how MATLAB supports the alpha channel， 
See Transparenc 





Choosing a Screen Bif Depth 


Depending on your System, you may be able to choose the Screen bit depth you 
wantto use. (There may be trade-offs between Screen bit depth and screen color 
resolution.) In general, 24-bit display mode produces the best results. If you 
need to use a lower Screen bit depth, 16-bit is generally preferable to 8-bit. 
However, keep in mind that a 16-bit display has certain limitations, such as: 


e。 An image may have finer gradations of color than a 16-bit display can 
represent. Ifa color is unavailable, MATLAB uses the closest approximation 
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e There are only 32 shades of gray available. Ifyou are working primarily with 
grayscale images, you may get better display results using 8-bit display 
mode, which provides up to 256 shades of gray. 


For information about reducing the number of colors used by an image, see 
“Reducing the Number of Colors in an Image”on page 13-6. 
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Reducing the Number of Colors in an Image 


This section describes hovw toreduce thenumber ofcolors in an indexed or RGB 
image.A discussion is also included about dithering, which is used by the 
toolbox's color-reduction functions (see below.) Ditheringis used to increase the 
apparent number of colors in an imasge. 


The table below summarizes the Image Processing Toolbox functions for color 








reduction. 

Funcfion Purpose 

imapprox Reduces the number of colors used by an indexed imasge， 
enabling you specify the number of colors in the new 
colormap. 

rgb2ind Converts an RGB image to an indexed image, enabling 
you to specify the number of colors to store in the new 
colormap. 





On systems with 24-bit color displays, RGB (truecolor) images can display up 
to 16,777,216 (i.e., 224) colors. On Systems with lower Screen bit depths, RGB 
images still displays reasonably well, because MATLAB automatically uses 
color approximation and dithering 计 mneeded. 


Indexed images, however, may cause problems they have alarge number of 
colors. In general, you should limit indexed images to 256 colors for the 
following reasons: 


e On systems with 8-bit display, indexed images with more than 256 colors will 
need to be dithered or mapped and, therefore, may not display wel!. 

e On Some platforms, colormaps cannot exceed 256 entries. 

e。 Ifan indexed image has more than 256 colors, MATLAB cannot store the 
image data in a uint8 array, but generally uses an arTray of class doub1le 


instead, making the storage Size ofthe image much larger (each pixel uses 
64 bits). 


e。 Most image file formats limit indexed images to 256 colors. If you write an 
indexed image with more than 256 colors (using imwrite) to a format that 
does not Support more than 256 colors, you will receive an erTor. 
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Using rgb2ind 

rgb2ind converts an RGB image to an indexed image, reducing the number of 
colors in the process. This fanction provides the following methods for 
approximating the colors in the original image: 


e Quantization 
= Uniform quantization 
= Minimum variance quantization 


e Colormap mapping 


The quality ofthe resulting image depends on the approximation method you 
use, the range of colors in the input image, and whether or not you use 
dithering. Note that different methods work better for different images. See 
“Dithering”on page 13-13 for a description of dithering and hovw to enable or 
disable it. 


Quantizaftion 

Reducing the number of colors in an image involves ga7tiza 万 o1. The fanction 
rgb2ind uses quantization as part of its color reduction algorithm. rgb2ind 
SUupports two quantization methods: xzform 9qxa7tizatiomn and 71277277727770 
QIQ72Ce QULQ7LIZ2Q 万 0O7. 


An important term in discussions of imnage quantization is 尺 GB color cxpe， 
which is used frequently throughout this section. The RGB color cube is a 
three-dimensional array of all of the colors that are defined for a particular 
data type. Since RGB images in MATLAB can be oftype uint8, uint16, or 
double, three possible color cube definitions exist. For example, 过 an RGB 
image is of class uint8, 256 values are defined for each color plane (red, blue， 
and green)j, and, in total, there will be 224 (or 16,777,216) colors defined by the 
color cube. This color cube is the same for all uint8 RGB images, regardless of 
which colors they actually use， 


The uint8, uint16, and double color cubes all have the same range of colors. 
In other words, the brightestred in an uint8 RGB image displays the same as 
the brightest red in a double RGB image. The difference is that the double 
RGB color cube has many more shades of red (and many more shades of all 
colors). Figure 13-1, below, shows an RGB color cube for a uint8 image. 
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White 
(255,255,255) 





2 了 


255 


Figure 13-1: RGB Color Cube for uint8 Images 


Quantization involves dividing the RGB color cube into anumber of smaller 
boxes, and then mapping all colors that fall within each box to the color value 
at the cemzter of that box. 


Uniform quantization and minimum variance quantization differ in the 
approach used to divide up the RGB color cube. With uniform quantization, the 
color cube is cut up into equal-sized boxes (Smaller cubes). With minimum 
variance quantization, the color cube is cut up into boxes (not necessarily 
cubes) of different sizes; the sizes of the boxes depend on hovw the colors are 
distributed in the image. 


Uniform Quantization。 To perform uniform quantization, call rgb2ind and specify 
a tolera7ce. The tolerance determines the size of the cube-shaped boxes into 
which the RGB color cube is divided. The allowable range for a tolerance 
setting is [0,1]. For example, ifyou specify atolerance of 0.1, the edges ofthe 
boxes are one-tenth the length ofthe RGB color cube and the maximum total 
Dumber of boxesg ig 


n = (floor(1/tol)+1) 3 
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The commands below perform uniform quantization with a tolerance of 0.1. 


RGB = imread( flowers.tif ); 
[x,map] = rgb2ind(RGB，0.1); 


Figure 13-2 illustrates uniform quantization ofa uint8 image. For clarity, the 
和 gure shows a two-dqimensional slice (or color plane) from the color cube where 
Red=0, and Green and Blue range from 0 to 255. The actual pixel values are 
denoted by the centers of the xs. 





G 
Center pixel volue 255 


Figure 13-2: Uniform Quanftization on a Slice of the RGB Color Cube 


After the color cube has been divided, all empty boxes are thrown out. 
Therefore, only one ofthe boxes in Figure 13-2 is used to produce a color for the 
colormap. As shown earlier, the maximum length of a colormap created by 
uniform quantization can be predicted, but the colormap can be smaller than 
the prediction because rgb2ind removes any colors that do not appear in the 
input image. 


Minimum Variance Quanfizafion， To perform minimum variance quantization, call 
rgb2ind and specify the maximum number of colors in the output image's 
colormap. The number you specify determines the number of boxes into which 
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the RGB color cube is divided. These commands use minimum variance 
quantization to create an indexed image with 185 colors， 


RGB = imread(' flLowers .tif ' ) ; 
[X,map] = rgb2ind(RGB ,185) ; 


Minimum variance quantization works by associating pixels into groups based 
on the variance between their pixel values. For example, a set of blue pixel 
values may be grouped together because none oftheir values is greater than 5 
位 om the center pixel ofthe grouPp. 


In minimum variance quantization, the boxes that divide the color cube vary 
in size, and do not necessarily fill the color cube. Isome areas ofthe color cube 
do not have pixels, there are no boxes in these areas. 


While you set the number of boxes, n, to be used by rgb2ind, the placement is 
determined by the algorithm as it analyzes the color data in your image. Once 
the image is divided into n optimally located boxes, the pixels within each box 
are mapped to the pixel value at the center of the box, as in uniform 
quantization. 


The resulting colormap usually has the number of entries you Specify. This is 
because the color cube is divided so that each region contains at least one color 
that appears in the input image. Ifthe input image uses fewer colors than the 
number you specify, the output colormap will have fewerthan n colors, and the 
output image will contain all ofthe colors ofthe input image. 


Figure 13-3 shows the same two-dimensional slice ofthe color cube as was used 
in Figure 13-2 (for demonstrating uniform quantization). Eleven boxes have 
been created using minimum variance quantization. 
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Cenier pixe| value 255 


Figure 13-3: Minimum Variance Quantizaftion on a Slice of the RGB Color 
Cube 


For a given number of colors, minimum variance quantization produces better 
results than uniform quantization, because it takes into account the actual 
data. Minimum variance quantization allocates more ofthe colormap entries to 
colors that appear frequently in the input image. It allocates fewer entries to 
colors that appear infrequently. As aresult, the accuracy of the colors is higher 
than with uniform quantization. For example, ifthe input image has many 
shades of green and few shades of red, there will be more greens than reds in 
the output colormap. Note that the computation for minimum variance 
quantization takes longer than that for uniform quantization 


Colormap Mapping 


Ifyou specify an actual colormap to use, rgb2ind uses color7zap 172QDDI7S 
(instead of quantization) to find the colors in the specified colormap that best 
match the colors in the RGB image. This method is useful ifyou need to create 
images that use a fxed colormap. For example, 这 you want to display multiple 
indexed images on an 8-bit display, you can avoid color problems by mapping 
them all to the same colormap. Colormap mapping produces a good 
approximation 这 the specified colormap has similar colors to those in the RGB 


13-11 


] 3 Color 





13-12 


image. Ifthe colormap does not have similar colors to those in the RGB image， 
this method produces poor results. 


This example illustrates mapping two images to the same colormap. The 
colormap used for the two images is created on the fy using the MATLAB 
fonction colorcube, which creates an RGB colormap containing the number of 
colors that you specify. (colorcube always creates the same colormap for a 
given number of colors.) Because the colormap includes colors all throughout 
the RGB color cube, the output images can reasonably approximate the input 
images， 


RGB1 = imread(' autumn.tif' ) ; 

RGB2 = imread( ' flowers.tif ' ) ; 

Xx1 = rgb2ind(RGB1,colorcube(128) ) ; 
X2 = rgb2ind(RGB2,colorcube(128) ) ; 





Notfte The function subimage is also helpful for displaying multiple indexed 
images. For more information see“Displaying Multiple Images in the Same 
Figure”on page 3-20 or the reference page for subimage. 





Reducing Colors in an Indexed Image 


Use imapprox when you need to reduce the number of colors in an indexed 
image. imapprox is based on rgb2ind and uses the same approximation 
methods. Essentially, imapprox first calls ind2rgb to convert the image toRGB 
format, and then calls rgb2ind to return a new indexed image with fewer 
Colors， 


For example, these commands create a version ofthe trees image with 64 
colors, rather than the original 128. 


1oad trees 
[Y,newmap] = imapprox(X,map,64) ; 
imshow(Y，newmap ) ; 


The quality of the resulting image depends on the approximation method you 
use, the range of colors in the input image, and whether or not you use 
dithering. Note that dqifferent methods work better for different images. See 
“Dithering”on page 13-13 for a description of dithering and hovw to enable or 
disable it. 


Reducing the Number of Colors in an 


Image 





Dithering 


When youuse rgb2indor imapprox to reduce thenumber ofcolors in an image， 
the resulting image may look inferior to the original, because some ofthe colors 
are lost. rgb2ind and imapprox both perform wzitPerimng to increase the 
apparent number of colors in the output image. Dithering changes the colors of 
pixels in a neighborhood so that the average color in each neighborhood 
approximates the original RGB color. 


For an example ofhovw dithering works, consider an image that contaings 8a 
number of dark pink pixels for which there is no exact match in the colormap. 
To create the appearance ofthis shade of pink, the Image Processing Toolbox 
selects a combination of colors fom the colormap, that, taken together as a 
Six-pixel group, approximate the desired shade of pink. From a distance, the 
pixels appear to be correct shade, but 让 you look up close at the image, you can 
see a blend of other shades, perhaps red and pale pink pixels. The commands 
below load a 24-bit image, and then use rgb2ind to create two indexed images 
with just eight colors each. 


rgb=imread( Lily.tif' ) ; 

imshow(rgb ) ; 
[X_no_dither,map]=rgb2ind(rgb,8，nodither ' ) ; 
[X_dither,map]=rgb2ind(rgb,8，dither  ) ; 
figure，imshow(X_no_dither,map) ; 
figure，imshow(X_dither ,map) ; 





Withoul diihering With dithering 


Figure 13-4:， Examples of Color Reduction with and Without Dithering 
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Notice that the dithered image has a larger number of apparent colors but is 
somewhat fuzzy-looking. The image produced without dithering has fewer 
apparent colors, but an improved spatial resolution when compared to the 
dithered image. One risk in doing color reduction without dithering is thatthe 
new image my contain false contours (see the rose in the upper-right corner). 
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Converting to Other Color Spaces 


The Image Processing Toolbox represents colors as RGB values, either directly 
(in an RGB image) or indirectly (in an indexed image, where the colormap is 
stored in RGB format). However, there are other models besides RGB for 
representing colors numerically. For example, a color can be represented by its 
hue, saturation, and value components (HSV) instead. The various models for 
color data are called color spaces. 


The functions in the Image Processing Toolbox that work with color assume 
thatimages usetheRGB color space. However, the toolbox provides Support for 
other color Spaces though a set of conversion functions. You can Use these 
fanctions to convert between RGB and the following color spaces: 


e National Television Systems Committee (NTSC) 

e YCbCr 

e Hue, saturation, value (HSV) 

These section describes these color spaces and the conversion routines for 
working with them: 

e“NTSC Color Space” 

e“YCbCr Color Space”on page 13-16 

e“HSV Color Space”on page 13-16 


NTSC Color Space 


The NTSC color space is used in televisiongs in the United States. One of the 
main advantages ofthis format is that grayscale information is separated 位 om 
color data, so the same signal can be used for both color and black and white 
sets. In theNTSC format, imnage data consists ofthree components: luminance 
(Y), hue (TD), and saturation (Q). The first component, luminance, represents 
grayscale information, while the last two components make up chrominance 
(color information). 


The function rgb2ntsc converts colormaps or RGB imasges to the NTSC color 
space. ntsc2rgb performs the reverse operation. 


For example, these commands convert the flowers image to NTSC format. 


RGB = imread( flowers.tif ' ) ; 
YIQ = rgb2ntsc(RGB ) ; 


13-15 


13 Color 





13-16 


Because luminance is one of the components of the NTSC format, the RGB to 
NTSC conversion is also useful for isolating the gray level information in an 
image. In fact, the toolbox functions rgb2gray and ind2gray use the rgb2ntsc 
fonction to extract the grayscale information from a color imasge. 


For example, these commands are equivalent to calling rgb2gray. 


YIQ = rgb2ntsc(RGB ) ; 
I=YIQ(:，: 1) 





Nofte Im YIQ color space, LI is one ofthe two color components, not the 
grayscale component. 





YCbcr Color Space 


The YCbCr color space is widely used for digital video. In this format， 
luminance information is stored as a single component (Y), and chrominance 
information is stored as two color-difference components (Cb and Cr). Cb 
represents the difference between the blue component and a reference value. 
Crrepresents the difference between the red component and a reference value. 


YCbcCr data can be double precision, but the color space is particularly well 
suited to uint8 data. For uint8 images, the data range for Y is [16, 235], and 
the range for Cb and Cr is [16, 240]. YCbCr leaves room at the top and bottom 
of the full uint8 range so that additional (nonimage) information can be 
included in a video stream. 


The function rgb2ycbcr converts colormaps or RGB imasges to the YCbCr color 
space. ycbcr2rgb performs the reverse oOperation. 
For example, these commands convert the flowers image to YCbCr format. 


RGB = imread(' flLowers .tif ' ) 
YCBCR = rgb2ycbcr(RGB ) ; 


HSV Color Space 


The HSV color space (hue, saturation, value) is often used by people whpho are 
Selecting colors (e.g., ofpaints or inks) from a color wheel or palette, because 进 
corresponds better to how people experience color than the RGB color space 
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does. The functions rgb2hsv and hsv2rgb convert images between theRGB and 
HSV color spaces. 


As hue varies from 0 to 1.0, the corresponding colors vary 位 om red, through 
yellow, green, cyan, blue, and magenta, back to red, so that there are actually 
red values both at 0 and 1.0. As saturation varies 位 om 0 to 1.0, the 
corresponding colors (hues) vary fom unsaturated (shades of gray) to fully 
saturated (no white component). As value, or brightness, varies 位 om 0 to 1.0， 
the corresponding colors become increasingly brighter. 


Figure 13-5 illustrates the HSV color space, 


Hue 






Saturation 


Figure 13-5: 川 ustrafion of the HSV Color Space 
The function rgb2hsv converts colormaps or RGB images to the HSV color 


space. hsv2rgb performs the reverse operation. These commands convert an 
RGB imasge to HSV color space. 
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RGB = imread('flowers.tif ' ) | 
HSV = rgb2hsv(RGB ) ; 


For closer inspection ofthe HSV color space, the next block of code displays the 
separate color planes (hue, saturation, and value) of an HSV image. 


RGB=reshape(ones(64,1)*reshape(jet(64) ,1,192),[64;,64;3]) ; 
HSV= 人 B) ; 
) ; 
) ; 
) ; 


H= We 


了 

了 
fiisiiaWt ) 
figure，imshow(S) ; 
figure，imshow(V) ; 
figure，imshow(RGB ) ; 


Hue plone Saiurotion plone 


0riginal image 








Value plone 


Figure 13-6: The Separated Color Planes of an HSV Image 
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The images in Figure 13-6 can be scrutinized for abetter understanding ofhow 
the HSV color space works. As you can see by looking at the hue plane imasge， 
hue values make a nice linear trangsition fom high to low. Ifyou compare the 
hue plane image against the original image, you can see that shades of deep 
blue have the highest values, and shades of deep red have the lowest values. 
(In actuajlity, there are values of red on both ends of the hue scale, which you 
can see 证 you look back at the model ofthe HSV color space in Figure 13-5. To 
avoid confusion, our sample image uses only the red values 位 om the pesz7727715 
of the hue range.) Saturation can be thought of as the purity of a color. As the 
saturation plane image shows, the colors with the highest saturation have the 
highest values and are represented as white. In the center ofthe saturation 
image, notice the various shades of gray. These correspond to a mixture of 
colors; the cyans, greens, and yellow shades are mixtures of true colors. Value 
is roughly equivalentto brightness, and you will notice that the brightest areasgs 
of the value plane correspond to the brightest colors in the original imasge. 
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This section describes the Image Processing Toolbox functions. 
Functions - By Category (p. 14-2) Contains a group of tables that organize the toolbox 
fanctions into category groups 


Functions -Alphabetical List (p. 14-16) Contains separate reference pages for each toolbox 
fanction 
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Functions - By Category 


This section provides brief descriptions of all the functions in the Image 
Processing Toolbox. The functions are listed in tables in the following broad 
categoriegs 


Ifyouknow thename ofa function, go directly to the“Functions -Alphabetical 
List”section to view its reference page. 


“Image Input, Output, and Functions for importing, exzporting, and 
Display” displaying images and converting between 
image formats 


“Spatial Transformation and Functions for performing spatial 
Registration2” transformations and image registration 


“Image Analysis and Statistics” Functions for performing image analysis 
and getting pixel values and statistics 


“Image Enhancement and Functions for image enhancement and 
Restoration” restoration, Such as deblurring. 

“Linear Filtering and Functions for creating and using linear7 
Transforms” 和 lters and transform 

“Morphological Operations” Functions for performing morphological 


image processing 


“Region-Based, Neighborhood， Functions to define regions of interest and 


and Block Processing” operate on these regionsg 

“Colormap and Color Space Functions for working with image color 
Functions? 

“Miscellaneous Functions? functions that perform image arithmetic， 


array 0perations, and set and get Image 
Processing Toolbox preferences 


Image Input, Output and Display 


e“Image Display” 
e“Image File IO” 


Functions - By Category 





e“Image Types and Type Conversiongs” 


Image Display 


Colorbar Display colorbar. (This is a MATLAB function.) 
getimage Get image data 位 om axes 
image Create and display image object. (This is a MATLAB 


function. See the online MATLAB Function Reference for its 
reference page.) 


imagescC Scale data and display as image. (This is a MATLAB function, 
See the online MATLAB Function Reference for its reference 
page.) 

immovie Make movie 们 om multiframe indexed image 

imshow Display image 

montage Display multiple imnage ffames as rectangular montage 

Subimage Display multiple images in single fgure 

truesize Adjust qisplay size of imnage 

warp Display image as texture-mapped surface 

ZOom Zoom in and out of image or 2-D plot. (This is a MATLAB 
fanction.) 
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Image File MO 
dicominfo 
dicomread 


Imfinfo 


Imread 


Imwrite 


Read metadata from a DICOM message 
Read a DICOM image 


Return information about image file. (This is a MATLAB 
fanction.) 


Read imasge file. (This is a MATLAB function.) 
Write image file. (This is a MATLAB fonction.) 


Image Types and Type Conversions 


dithenr 
doub1le 


gray2ind 
graySlice 
graythresh 
Im2bw 
im2doub1le 
Im2java 
im2uint16 
Im2uint8 
ind2gray 
ind2rgb 
1ISbw 
Isgray 
Isind 
isrgb 


1abel12rgb 


Convert image using dithering 


Convert data to double precision. (This is a MATLAB 
fonction .) 


Convert intensity image to indexed image 

Create indexed image 他 om intengsity image by thresholding 
Compute global image threshold using Otsus method 
Convert image to binary image by thresholding 
Convert image array to double precision 

Convert image to instance of Java image object 
Convert image arTray to 16-bit unsigned integers 
Convert image array to 8-bit unsigned integers 
Convert indexed image to intensity image 

Convert indexed image to RGB image 

Return true for binary image 

Return true for intensity image 

Return true for indexed image 

Return true for RGB image 


Convert a label matrix to an RGB image 
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mat2gray 
rgb2gray 
rgb2ind 
uUint16 


Uint8 


Convert matrix to intengsity image 
Convert RGB image or colormap to grayscale 
Convert RGB image to indexed image 


Convert data to unsigned 16-bit integers. (This is a MATLAB 
fanction.) 


Convert data to unsigned 8-bit integers. (This is a MATLAB 
fanction.) 


Spaftial Transformaftion and Registraftion 


e“Spatial Transformations” 


e“Image Registration” 
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Spaftial Transformaftions 


checkerbpoard 
findbounds 
fJliptform 
Imcrop 
ImresiIze 
Imrotate 


Interp2 


Imtransform 
makeresamp1er 
maketfornm 
tformarray 
tformfwd 


tformzinv 


Create checkerboard image 

Find output bounds for spatial transformation 

Flip the input and output roles of a TFORM structure 
Crop image 

Reslize image 

Rotate image 


2-D data interpolation. (This is a MATLAB function. See 
the online MATLAB Function Reference for its reference 


page.) 

Apply 2-D spatial transformation to image 

Create resampling Structure 

Create geometric transformation Structure 

Geometric transformation of a multi-dimensional array 
Apply forward geometric transformation 


Apply inverse geometric transformation 


Image Registration 


cpcorr 
cp2tform 
CpSselect 
cpstruct2pairs 


normxcorr2 


Tune control point locations using cross-correlation 
Infer geometric transformation 位 om control point pairs 
Control point selection tool 

Convert CPSTRUCT to valid pairs of control points 


Normalized two-dqimensional cross-correlation 


Image Analysis and Stafistics 


e“Image Analysis” 
e“Pixel Values and StatisticSs?” 
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Image Analysis 


edge Find edges in intensity image 

qtdecomp Perform quadtree decomposition 

qtgetb1k Get block values in quadtree decomposition 
qtsetb1k Set block values in quadtree decomposition 


Pixel Values and Stafistics 


Corr2 Compute 2-D correlation coefficient 

imcontour Create contour plot of image data 

imfeature Compute feature measurements for image regions 
imhist Display histogram of image data 

impixe1 Determine pixel color values 

improfile Compute pixel-value cross-sections along line segments 
mean2 Compute mean of matrix elements 

pixval Display information about image pixels 

regionprops Measure properties of imnage regions 

std2 Compute standard deviation of matrix elements 


Image Enhancement and Restoration 


e“Image Enhancement 


se“Image Restoration (Deblurring)” 
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Image Enhancement 


histeq 
imadjust 
Imnoise 
medfilt2 
ordfilt2 
Stretch1lim 


Wiener2 


Enhance contrast using histogram equalization 
Adjust image intensity values or colormap 

Add noise to an image 

Perform 2-D median 玫 ltering 

Perform 2-D order-statistic filtering 

Find limits to contrast stretch an image 


Perform 2-D adaptive noise-removal filtering 


Image Restoration (Deblurring) 


deconvb1lLind 


deconvlLucy 


deconvreg 
deconvwnr 
edgetaper 
otf2psf 
psf2otf 


Restore image using blind deconvolution 


Restore image using accelerated Richardson-Lucy 
algorithm 


Restore image using Regularized filter 

Restore image using Wiener filter 

Taper the discontinuities along the image edges 

Convert optical transfer function to point-spread function 


Convert point-spread function to optical transfer function 


Linear Filfering and Transforms 


e“Linear Filtering” 
e“Linear 2-D Filter Design” 


e“Image Transforms” 
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Linear Filtering 


Conv2 
ConvmtX2 
convn 
filter2 
fspecial 


Imf1IlLtenr 


Perform 2-D convolution. (This is a MATLAB fonction.) 
Compute 2-D convolution matrix 

Perform N-D convolution. (This is a MATLAB function.) 
Perform 2-D filtering. (This is a MATLAB fanction.) 
Create predefined filters 


Multidimensional image filtering 


Linear 2-D Filter Design 


freqspace 


freqz2 
fsamp2 
ftrans2 
fwind1l 
fwind2 


Determine 2-D frequency response spacing. (This is a 
MATLAB function.) 


Compute 2-D 他 equency response 

Design 2-D FIR flter using 他 equency sampling 
Design 2-D FIR filter using 他 equency transformation 
Design 2-D FIR flter using 1-D window method 
Design 2-D FIR flter using 2-D window method 


Image Transforms 


dct2 
dctmtX 
fft2 


fftn 


fftshift 


Idct2 
ifft2 


Compute 2-D discrete cosine transform 
Compute discrete cosine transform matTrix 


Compute 2-D fast Fourier transform. (This is a MATLAB 
fanction.) 


Compute N-D fast Fourier transform. (This is a MATLAB 
fanction.) 


Reverse quadrants of output of FFT' (This is a MATLAB 
fanction.) 


Compute 2-D inverse discrete cosine transform 


Compute 2-D inverse fast Fourier transform. (This is a 
MATLAB fanction.) 
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ifftn Compute N-D inverse fast Fourier transform. (This is a 
MATLAB fonction.) 

iradon Compute inverse Radon transform 

phantom Generate a head phantom image 

radon Compute Radon trangsform 


Morphological Operations 


es“JIntensity and Binary Images” 
e“Binary Images” 
e“Structuring Element (STREIL) Creation and Manipulation” 
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Intensity and Binary Images 


conndef 
Imbothat 
ImcJlearborder 
ImcJlose 
ImdIlate 
Imerode 
Imextendedmax 
Imextendedmin 
imfil1 

ImhmaxX 

ImhmzIn 
Imimposemin 
Imopen 
Imreconstruct 
Imregionalmax 
imregionalmin 
Imtophat 


watershed 


Binary Images 
applLyLut 
bwarea 
bwareaopen 
bwdist 
bweu]ler 


bwfil1 


Default connectivity array 

Perform bottom-hat filtering 
Suppress light structures connected to image border 
Close image 

Dilate image 

Erode image 

卫 xtended-maxima transform 

卫 xtended-minima transform 

Fill image regiongs 

再-maxima transform 

也 -minima transform 

Impose minima 

Open image 

Perform morphological reconstruction 
Regional maxima of image 

Regional minima of image 

Perform tophat 有 ltering 


Find image watershed regions 


Perform neighborhood operations using lookup tables 
Area of objects in binary image 

Binary area open; remove small objects 

Distance transform 

Euler number of binary image 


Fill background regions in binary image 
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bwhitmiss Binary hit-miss operation 

bw1labe1 Label connected components in 2-D binary image 
bwlabeln Label connected components in N-D binary image. 
bwmorph Perform morphological operations on binary image 
bwpack Pack binary image 

bwperim Find perimeter of objects in binary image 
bwselect Select objects in binary image 

bwulterode Ultimate erosion 

bwunpack Unpack a packed binary image 

imregionalmin Regional minima ofimage 

imtophat Perform tophat filtering 

makelut Construct lookup table for use with applLy1lLut 


Structuring Element (STREU Creafion and Manipulation 


getheight Get the height of a structuring element 

getneighbors Get structuring element neighbor locations and heights 
getnhood Get structuring element neighborhood 

getsedquence 卫 xtract sequence of decomposed structuring elements 
isflat Return true for flat structuring element 

reflect Reflect structuring element 

Strel Create morphological structuring element 

translate Translate structuring element 


Region-Based, Neighborhood, and Block 
Processing 


e“Region-Based Processing” 
e“Neighborhood and Block Processing” 
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Region-Based Processing 


roicolor Select region of interest, based on color 
Foifil1 Smoothjly interpolate within arbitrary region 
roifilt2 Filter a region of interest 

roipoly Select polygonal region of interest 


Neighborhood and Block Processing 


bestb1k Choose block size for block processing 

blkproc Implement distinct block processing for image 

Co1L2im Rearrange matrix columns into blocks 

CO1Lfilt Perform neighborhood operations using colummnwise functiongs 
im2col Rearrange image blocks into colummns 

nl1filter Perform general sliding-neighborhood operationgs 


Colormap and Color Space Functions 


e“Colormap Manipulation” 
e“Color Space Conversions” 
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Colormap Manipulafion 


brighten 
cmpermute 
cmunique 
Colormap 
Imapprox 


rgbp1ot 


Brighten or darken colormap. (This is a MATLAB function.) 
Rearrange colors in colormap 

Find unique colormap colors and corresponding image 

Set or get color lookup table. (This is a MATLAB function.) 
Approximate indexed image by one with fewer colors 


Plot RGB colormap components. (This is a MATLAB 
fonction .) 


Color Space Conversions 


hsv2rgb 


ntsc2rgb 
rgb2hsv 


rgb2ntsc 
rgb2ycbcnr 
ycbcr2rgb 


Convert HSV values to RGB color space. (This is a MATLAB 
fonction.) 


Convert NTSC values to RGB color space 


Convert RGB values to HSV color space. (This is a MATLAB 
fonction.) 


Convert RGB values to NTSC color space 
Convert RGB values to YCbCr color space 
Convert YCbCr values to RGB color space 


NMiscellaneous Funcftions 


e“Image Arithmetic” 


e“Toolbox Preferences” 


e“Array Operations” 
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Image Arithmetic 
imabsdiff Compute absolute difference of two images 
imadd Add two images, or add constant to image 


imcomplement Complement image 


imdivide Divide two images, or divide image by constant. 
imlincomb Compute linear combination of images 

immu1ltip1y Mujltiply two images, or multiply image by constant 
imsubtract Subtract two images, or Subtract constant 位 om image 


Toolbox Preferences 
iptgetpref Getvalue of Image Processing Toolbox preference 


iptsetpref Set value of Image Processing Toolbox preference 


Array Operations 


padarray Pad an arTray 
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Functions - Alphabetical List 


This section contains detailed descriptions of all toolbox functions. 也 ach 
fonction reference page contains some or all of this information: 
e The function name 
e The purpose of the function 
e The fanction syntax 
All valid input argument and output argument combinationgs are shown. In 


Some cases, an ellijpsis (.. .) is used for the input arguments. This means that 


all preceding input argument combinations are valid for the specified output 
argument(S). 


e A description of each argument 
e A description ofthe function 

e。 Additional remarks about usage 
e An example of usage 

e Related functions 
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Purpose 
Syntax 


Descripfion 


Class Suppor 


Algorithm 


Perform neighborhood operations on binary images using lookup tables 
A = applylut(BW,LUT) 


A = applylut(BW,LUT) performs a 2-by-2 or 3-by-3 neighborhood operation on 
binary image BW by using a lookup table (LUT). LUT is either a 16-element or 
512-element vector returned by makelut. The vector consists of the output 
values for all possible 2-by-2 or 3-by-3 neighborhoods. 


BW can be numeric or logical, and it must be real, two-dimensional, and 
nonsparse. LUT can be numeric or logical, and it must be a real vector with 16 
or 512 elements. Ifall the elements of LUT are 0 or 1, then Ais logical. Iall the 
elements of LUT are integers between 0 and 255, then Ais uint8. For all other 
cagses, Als doub1e. 


applylut performs a neighborhood operation on a binary image by producing 
amatrix ofindices into Lut, and then replacing the indices with the actual 
values in Lut. The specific algorithm used depends on whether you use 2-by-2 
or 3-by-3 neighborhoods. 


2-by-2 Neighborhoods 


For 2-by-2 neighborhoodqds, Ilength(Lut) is 16. There are four pixels in each 
neighborhood, and two possible states for each pixel, so the total number of 
permutations is 24 = 16. 


To produce the matrix ofindqices, applylut convolves the binary image BW with 
this matrix. 


8 2 
4 1 


Theresulting convolution contains integervalues in therange [0,15]. app1LylLut 
uses the central part of the convolution, ofthe same size as BW, and adds 1 to 
each value to shift the range to [1,16]. It then constructs A by replacing the 
values in the cells ofthe index matrix with the values in Lut that the indices 
point to. 
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Example 


See Also 
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3-by-3 Neighborhoods 

For 3-by-3 neighborhoodqds, Ilength(1Lut) is 512. There are nine pixels in each 
neighborhood, and 2 possible states for each pixel, so the total number of 
permutationgs 18 29 -= 512. 


To produce the matrix ofindqices, app1lylLut convolves the binary image BW with 
this matrix. 


256 32 4 
128 16 2 
64 8 1 


The resulting convolution contains integer values in the range [0,511|]. 
applylut uses the central part of the convolution, ofthe same Size as BW, and 
adds 1l to each value to shift the range to [1,512]. It then constructs A by 
replacing the values in the cells ofthe index matrix with the values in LIutthat 
the indices point to. 


In this exzample, you perform erosion using a 2-by-2 neighborhood. An output 
pixel is on only 计 all four ofthe input pixels neighborhood pixels are on. 


1Lut = makelut(' Sum(x(:) 
BW1 = imread( text.tif' 
BW2 = applylut(BW1 ,Lut) ; 
imshow(BW1 ) 
figure，imshow(BW2) 
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Purpose 


Syntax 


Descripfion 


Algorithm 


Example 


See Also 


Determine block size for block processing 


Sliz = bestblk([m nl],kKk) 
[mb,nb] = bestblk([m nl]l,Kk) 


Siz = bestblk([m n],k) returns, for an m-by-n image, the optimal block size 
for block processing. k is a scalar specifying the maximum row and column 
dimensiongs for the block; ifthe argument is omitted, it defaults to 100. The 


return value, siz, is a 1-by-2 vector containing the row and column dimensiongs 
for the block. 


[mb,nb] = bestblk([m n],k) returns the row and column dimensions for the 
block in mb and nb, respectively. 


bestb1lk returns the optimal block size given m, n, and k. The algorithm for 
determining siz igs: 


e Ifmis less than or equal to k, return m. 


e Ifmis greater than k, consider all values between min(m/10,k/12) and K. 
Return the value that minimizes the padding required. 


The same algorithm is then repeated for n. 
SiZz = bestb1lk([640 800],72) 
Siz = 
64 50 


blkproc 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 
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Implement distinct block processing for an image 


B = blkproc(A,[mn]l,fun) 

B = blkproc(A,[mn]l,fun,P1,P2,...) 

B = blkproc(A;,[mn]l,[mborder nborder],fun,...) 
B = blkproc(A，indexed ，..,) 


B = blkproc(A,[m n],fun) processes the imageAby applying the fonction fun 
to each distinct m-by-n block of A, padding A with zeros 让 necessary. fun is a 
fanction that accepts an m-by-n matrix, x, and returns a matrix, Vector，or 
Scalar y. 


yY= fun(x) 


blkproc does not require that y be the same size as x. However, B is the same 
Size as Aonly 计 y is the same Size as X. 


B = blkproc(A,[m n],fun,P1,P2,...) passes the additional parameters 
P1,P2,...，tofun. 


B = blkproc(A,[m n],[mborder nborder],fun,...) defines an overlapping 
border around the blocks. blkproc extends the original m-by-n blocks by 
mborder on the top and bottom, and nborder on the left and right, resulting in 
blocks of size (m+2x*mborder)-by-(n+2xnborder). The blkproc function pads 
the border with zeros, ifnecessary, on the edges of A. The function fun should 
operate on the extended block. 


The line below processes an image matrix as 4-by-6 blocks, each having a row 
border of 2 and a column border of 3. Because each 4-by-6 block has this 2-by-3 
border, fun actually operates on blocks of size 8-by-12. 


B = blkproc(A,[4 6],[2 3],fun,...) 
B = blkproc(A，indexed ' ,...) processes Aas an indexed imnage, padding 


with zerogs ifthe class ofAlis uint8 or uint16, or onegs ifthe class ofAlis doub1e. 


The input image Acan be ofany class supported by fun. The class ofB depends 
on the class ofthe output from fun. 


blkproc 





fun can be afunction_handle created using e. This example uses bl1kproc to 
compute the 2-D DCT of each 8-by-8 block to the standard deviation of the 


elements in that block. 


Example 


II = imnread( cameraman.tif ' ) ; 
fun = Qdct2 ; 

Jd = blkproc(I,[8 8],fun) ; 
Imagesc(Jyd)，colormap (hot ) 





50 100 150 200 250 


fun can also be an inline object. This example uses blLkproc to set the pixels in 
each 8-by-8 block to the standard deviation of the elements in that block. 


I= imread('alumgrns.tif' ) ; 

fun = inline('std2(S)*ones(Size(Xx)) '); 

I2 = blkproc(I,[8 8]，std2(x)*ones(Size(x)) ); 
imshow(I) 

figure，imshow(I2,[]); 
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See Also colfilt, nlfilter, inline 
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Purpose Brighten or dqarken a colormap 


brightenis a MATLAB function. To get help for this function, select MATLAB 
Help 人 om the Help menu and view the online function reference page. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Algorithm 


Example 
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Compute the area of the objects in a binary image 
total = bwarea(BW) 


total = bwarea(BW) estimates the area of the objects in binary image BW. 
total is a scalar whose value corresponds roughly to the total number of on 
pixels in the image, but may not be exactly the same because different patterns 
of pixels are weighted differently. 


BW can be numeric or logical. For numeric input, any non-zero pixels are 
considered to be "on'". The return value, total, is of class doub1e. 


bwarea estimates the area of all ofthe on pixels in an image by summing the 
areas of each pixel in the image. The area of an individual pixel is determined 
by looking at its 2-by-2 neighborhood. There are six different patterns, each 
representing a different area: 

e。 了 Patterns with zero on pixels (area = 0) 

se Patterns with one on pixel (area = 1/4) 

e Patterns with two adjacent on pixels (area = 1/2) 

se Patterns with two diagonal on pixels (area = 3/4) 

e Patterns with three on pixels (area = 7/8) 

se Patterns with all four on pixels (area = 1]1) 


Keep in mind that each pixel is part of four different 2-by-2 neighborhoods. 
This means, for example, that a single on pixel surrounded by off pixels has a 
total area of 1L. 


This example computes the area in the objects of a 256-by-256 binary image. 


BW = imread( :circles.tif ' ) ; 
Imshow(BW) ; 


bwareqa 








bwarea(BW') 
ans = 
15799 
See Also bweuler, bwperim 
References Pratt，William 开 . Diszta/ 17asge Process115. New York: John Wiley & Sons， 


Inc., 1991. p. 634. 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Algorithm 
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Binary area open; remove small objects 


BW2 
BW2 


bwareaopen(BW,P) 
bwareaopen(BW,P,CONN) 


BW2 = bwareaopen(BW,P) removes from a binary image all connected 
components (objects) that have fewer than P pixels, producing another binary 
image BW2. The default connectivity is 8 for two dimensions, 26 for three 
dimensions, and conndef(ndims(BW) ，maximal') for higher dimensions. 


BW2 = bwareaopen(BW,P,CONN) specifies the desired connectivity. CONN may 
have any of the following scalar values. 





Value Meaning 





Two-dimensional connectivities 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by-.…-by-3 matrix of 0's and 1's. The 1-valued elements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element， 


BW can be a logical or numeric array of any dimension, and it must be 
nonsparse. The return value, BW2, is of class 1ogical. 


The basic steps are: 


1 Determine the connected components， 
L = bwlabeln(BW，CONN) ; 


bwareaopen 





Example 


2 Compute the area of each component， 
S = regionprops(L， 'Area ) |; 


3 Remove Small objects. 
bw2 = Ismember(L，find([S.Area]l >= P) ); 
Remove all objects containing fewer than 40 pixels in an image. 


1 Read in the image and display 让 . 
bw = imread( text.tif ' ) ; 
Imshow(bw) 


Crfross-Cotrelattion Used 
ToLocate 各 民 nowtn 
Taregetin an Image 


Text Running 
In Anothet 
Direction 





2 Remove all objects smaller than 40 pixels. Note the missing letters. 


bw2 = bwareaopen(bw,40) ; 
figure，imshow(bw2 ) 


Coss Cotre aa on Used 
ToLocae 和 Knowtn 
Targe 0an Image 


吕 
纪 
马 
号 
色 
网 
由 
请 


册 
< 二 
心 
思 
总 
号 
引 
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See Also bwlabel, bwlabeln, conndef, regionprops. 
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Purpose 


Synftax 


Descripfion 


Distance transform 


D = bwdist(BW) 
[D,L] = bwdist(BW) 
[D,L] = bwdist(BW,METHOD) 


D = bwdist(BW) computes the Euclidean distance transform of the binary 
image BW. For each pixel in BW, the distance transform assigns a number that 
is the distance between that pixel and the nearest nonzero pixel of BW. bwdist 
usegs the Euclidean distance metric by default. BW can have any dimension. D is 
the same size as BW. 


[D,L] = bwdist(BW) also computes the nearest-neighbor transform and 
returns it as a label matrix, L, which has the same size as BW and D. 了 Each 
element of L contaings the linear index of the nearest nonzero pixel of BW. 


[D,L] = bwdist(BW,METHOD) computes the distance transform, where METHOD 
specifies an alternate distance metric. METHOD can take any of these values. 











'chessboard In 2-D, the chessboard distance between (xi;y1) 
and (xz,y2) js: 
72QX(|z1 一 Xo|, |y1 -ya|) 
"cityb1ock' In 2-D,the cityblock distance between (xi,y1) and 


(xz2,y2) 18: 
Pa -zxal+|y1-y3| 
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Class suppor 


Example 


14-34 





'euc1lidean' In 2-D, the Euclidean distance between (xiyy1) 
and (xz,y2) is: 


ea -za)2+ 01 -ya)2 


This is the default method. 





'quasi-euclidean'” In 2-D,the quasi-Euclidean distance between 
(x1y1) and (xz,y2) is: 


ai -za| +(\2-1J)p1i-y2 
(V2 -1)|xzi-xa| 十 pi-ya 


9 








1 一 X?| 六 pi-y?| 


, Of 几 e7IUISe 








The METHOD string may be abbreviated. 





Nofte bwdist uses fast algorithms to compute the true Euclidean distance 
trangsform, especially in the 2-D case. The other methods are provided 
primarily for pedagogical reasons. Howevem the alternative distance 
transforms are sometimes significantly faster for multidimensional input 
images, particularly those that have many nonzero elements. 





BW can be numeric or logical, and 让 must be nonsparse.D andL are double 
matrices with the same Size as BW. 


Here is a simple example ofthe Euclidean distance transform. 


bw 
bw = 


zeros(5,5); bw(2,2) = 1; bw(4,4) = 1 


人 
口 口 口 一 口 
人 
0 
人 


[D,L] = bwdist(bw) 


bwdist 





D = 
1.4142 1.0000 1.4142 2.2361 3.1623 
1.0000 0 1.0000 2.0000 2.2361 
1.4142 1.0000 1.4142 1.0000 1.4142 
2.2361 2.0000 1.0000 0 1.0000 
3.1623 2.2361 1.4142 1.0000 1.4142 
L = 
7 7 7 7 7 
7 7 7 7 19 
7 7 7 19 19 
7 7 19 19 19 
7 19 19 19 19 


In the nearest neighbor matrix, L, the values 7 and 19 represent the position of 
the nonzero elements using linear matrix indexing. Ifa pixel contains a 7, its 
closest nonzero neighbor is at linear position 7. 


This example compares the 2-D distance transforms for the each of the 
Supported distance methods. In the figure, note how the quasi-euclidean 
distance transform best approximates the circular shape achieved by the 
euclidean distance method. 


bw = zeros(200,200); bw(50,50) = 1; bw(50,150) = 1 
bw(150,100) = 1; 

D1 = bwdist(bw，euclidean ) ; 

D2 = bwdist(bw，citybJlock ) ; 

D3 = bwdist(bw， chessboard ' ) ; 

D4 = bwdist(bw，quasi-euclidean ) ; 

figure 

Subplot(2,2,1)，Ssubimage(mat2gray(D1))，tit1le(' EuUclLidean ') 
hold on，imcontour(D1) 
Subplot(2,2,2)，Ssubimage(mat2gray(D2))，title(' City block ') 
hold on，ijimcontour(D2) 
Subplot(2,2,3)，Ssubimage(mat2gray(D3) )，title(' Chessboard ') 
hold on，imcontour(D3) 
Subplot(2,2,4)，Ssubimage(mat2gray(D4) )，title('Quasi-Euclidean ') 
hold on，imcontour(D4) 
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Euclidean City block 






50 
100 
150 二 

50 100 150 50 100 150 200 


Chessboard Quasi-Euclidean 


50 100 150 200 50 100 150 200 


200 








This example compares isosurface plots for the distance transforms of a 3-D 
image containing a single nonzero pixel in the center. 


bw = zeros(50,50,50); bw(25,25,25) = 1; 
D1 = bwdist(bw) ; 

D2 = bwdist(bw，cityblock ) ; 

D3 = bwdist(bw，chessboard ) ; 

D4 = bwdist(bw，quasi-euclidean ') ; 
figure 


Subplot(2,2,1)，isosurface(D1,15)，axis equal，Vview(3) 
camlight，1ighting gouraud，title('` Euclidean ') 
Subplot(2,2,2)，isosurface(D2,15)，axis equal，Vview(3) 
camlight，1ighting gouraud，title(' City block ' ) 
Subplot(2,2,3)，isosurface(D3,15)，axis equal，Vview(3) 
camlight，1ighting gouraud，tit1le( Chessboard ') 
Subplot(2,2,4)，isosurface(D4,15)，axis equal，Vview(3) 
camlight，1ighting gouraud，title( Quasi-EUclLidean ') 
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Algorithm 


Euclidean City block 
4 加 如 
20 乌 20 心 
如 40 4 各 如 
30 30 
20 1 20 20 们 20 
Chessboard Quasi-Euclidean 





For two-dqimensional Euclidean distance transforms, bwdist uses the second 
algorithm described in: 


Heinz Breu, Joseph Gil, David Kirkpatrick, and Michael Werman， “Linear 
Time Euclidean Distance Transform Algorithms,”7 瓦 严 玉 T7a7zsactio7s 07 
Patterm APalysis aa MacHine Tatellisezce, vol. 17, no. 5 May 1995, pp. 
529-533. 


For higher qimensional 卫 uclidean distance transforms, bwdist uses anearest 
neighbor search on an optimized Kdq-tree, as described in: 


Jerome 瓦 . Friedman, Jon Louis Bentley, and Raphael Ari Finkel“An 
Algorithm for Finding Best Matches in Logarithmic 了 xpected Time,”ACMI 
77ra7sactzoms om Matnematics Softare, vol. 3, no. 3, September 1997, pp. 
209-226. 


For cityblock, chessboard, and quasi-Euclidean distance transforms, bwdist 
uses the two-pass, sequential scanning algorithm described in: 


A. Rosenfeld and J. Pfaltz，“Sequential operations in digital picture 
processing,”。Joxv7rPal oftPeAssociatio7 Jor ComzputiSs MacAzmnery vol. 13, no. 
4, 1966, pp. 471-494. 
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The different distance measures are achieved by using different sets of weights 
in the Scans, as described in: 


David Paglieroni“Distance Transforms: Properties and Machine Vision 
Applications,”Co7azpzter Visiom, Grapjics, a1Q 7112aSse Processi15;: GrapAicaL 
Moaels aa 717arase Processi1ls, vol. 54, no. 1 January 1992, pp. 57-58. 


See Also watershed 
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Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


Algorithm 


See Also 


Compute the Euler number of a binary image 
eul = bweuler(BW,n) 


eul = bweuler(BW,n) returns the Euler number for the binary image BW. The 
return value, eul, js a scalar whose value is the total number of objects in the 
image minus the total number of holes in those objects. The argument n can 
have avalue of either 4 or 8, where 4 specifies 4-connected objects and 8 
specifies 8-connected objects; ifthe argument is omitted, it defaults to 8. 


BW can be numeric or logical and t must be real, nonsparse and 
two-dimensional. The return value, eul, is of class doub1e. 


BW = imread(' circles.tif ' ) 
Imshow(BW) ; 





bweuler(BW) 


ans = 


bweuler computes the Euler number by considering patterns of convexity and 
concavity in local 2-by-2 neighborhoods. See [2] for a discussion of the 
algorithm used. 


bwmorph, bwperim 


14-39 


bweuler 





References [Horn, Berthold P. 开 ., RRopot Vision. New York: McGraw-Hill, 1986. pp. 
73-77. 


[2] Pratt,，William 开 . Diszta/! 1rase Processi1n1g. New York: John Wiley & Sons， 
Inc., 1991. p. 633. 
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Purpose 


Syntax 


Descripfion 


Fill background regions in a binary image 





Nofte This function is obsolete and may be removed in future versions. Use 
imfill instead. 





BW2 = bwfill(BW1, crn) 
BW2 = bwfil1l(BW1，,n) 
[BW2 ,idx]l = bwfil1(...,) 


BW2 = bwfill(x,y,，BW1,xiyyin) 
[x,y,BW2 ,idx,Xxi,yi]l = bwfil1(...) 


BW2 = bwfiLlL(BW1,'holes'，n) 
[BW2 ,idx] = bwfilL(BW1,'holes',n) 


BW2 = bwfil1(BW1,c,r,n) performs aflood-fill operation on the input binary 
image BW1, starting from the pixel (rc). Ifr and c are equal-length vectors, the 
fl] is performed in parallel 人 om the starting pixels (Fr(k),c(k)). n can have a 
value of either 4 or 8 (the default), where 4 specifies 4-connected foreground 
and 8 specifies 8-connected foreground. The foreground of BW1 comprises the on 
pixels (i.e., having value of 1). 


BW2 = bwfil1l(BW1,n) displays the image BW1 on the Screen and lets you Select 
the starting points using the mouse. If you omit BW1, bwfi11 operates on the 
image in the current axes. Use normal button clicks to add points. Press 
Backspace or Delete to remove the previously selected point. A shift-click， 
Tight-click, or double-click selects a final point and then starts the fi]1; pressing 
Return finishes the selection without adding a point. 


[BW2 ,idx] = bwfil1(...) retumns the linear indqices ofall pixels flled by 
bwfil11. 


BW2 = bwfil1(x,y,BW1,xi,yi,n) uses the vectors x and y to establish a 
nondefault spatial coordinate System for BW1. xi and yi are Scalars oF 
equal-length vectors that specify locationgs in this coordinate system， 
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[x,y,BW2,idx,xi,yi]l = bwfil1(...)returnstheXDataandYDatain x and y; 
the output image in BW2; linear indices of all filled pixels in idx; and the fi]1 
starting points in xi and yi. 


BW2 = bwfil1(BW1，'holes',n) flls the holes in the binary image BW1. bwfil11 
automatically determines which pixels are in object holes, and then changes 
the value of those pixels from 0 to 1. n defaults to 8 计 you omit the argument. 


[BW2 ,idx] = bwfil1(BW1，holes',n) returns the linear indices of all pixels 
和 lled in by bwfil11. 


Ifbwfillis used with no output arguments, the resulting image is displayed 
in anevw fgure. 


Remarks bwfill differs fom many other binary image operations in that it operates on 
background pixels, rather than foreground pixels. Ifthe foreground is 
8-connected, the background is 4-connected, and vice versa. Note, however， 
that you specify the connectedness of the joresrox7a when you call bwfil11. 


Class Suppor The input image, BW1, must be anumeric or logical matrix. The output image， 
BW2, is logical. 


Example BW1 = [1 0 0 0 0 0 0 0 
1 1 1 1 1 0 0 0 
1 0 0 0 1 0 1 0 
1 0 0 0 1 1 1 0 
1 1 1 1 0 1 1 1 
1 0 0 1 1 0 1 0 
1 0 0 0 1 0 1 0 
1 0 0 0 1 1 1 0] 
BW2 = bwfil1(BW1,3,3,8) 
BW2 = 
1 0 0 0 0 0 0 0 
1 1 1 1 1 0 0 0 
1 1 1 1 1 0 1 0 
1 1 1 1 1 1 1 0 
1 1 1 1 0 1 1 1 
1 0 0 1 1 0 1 0 
1 0 0 0 1 0 1 0 
1 0 0 0 1 1 0 
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II = imnread(' blood1.tif ) ; 
BW3 = ~iIim2bw(I) ; 

BW4 = bwfil1(BW3，holes ) 
imshow(BW3 ) 
figure，imshow(BW4) 





See Also bwselect, roifil1 
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PurPpose 


Syntax 


Descripfion 


Class supPpor 


Example 
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Binary hit-and-miss operation 


BW2 = bwhitmiss(BW1,SE1,SE2) 
BW2 = bwhitmiss(BW1,INTERVAL) 


BW2 = bwhitmiss(BW1,SE1,SE2) performs the hit-and-miss operation defined 
bythe structuring elements SE1 and SE2. The hit-and-miss operation preserves 
pixels whose neighborhoods match the shape of SE1 and dont match the shape 
of SE2. SE1 and SE2 may be flat structuring element objects, created by stre1， 
or neighborhood arrays. The neighborhoods of SE1 and SE2 should nothave any 
overlapping elements. The syntax bwhitmiss(BW1,SE1,SE2) is equivalent to 
imerode(BW1,SE1)& imerode(-~BW1 ,SE2 ) . 


BW2 = bwhitmiss(BW1,INTERVAL) performs the hit-and-miss operation defined 
in terms of a single array, called an ;zterua!. An interval is an array whose 
elements can contain either 1, 0, or -1. The 1-valued elements make up the 
domain of SE1; the -1-valued elements make up the domain of SE2; and the 
0-valued elements are ignored. The syntax bwhitmiss(INTERVAL) is 
equivalent to bwhitmiss(BW1,INTERVAL == 1，INTERVAL == -1). 


BW1 can be a logical or numeric array of any dimension, and it must be 
nonsparse. BW2 is always a logical array with the same Size as BW1. SE1 and SE2 
mustbeflat STREL objects or they must be logical or numeric arrays containing 
1s and 0s. INTERVAL must be an array containing 1s, 0s, and - 18. 


This exzample performs the hit-and-miss operation on abinary image using an 
interval. 


bw= [000000 
001100 
011110 
011110 
001100 
001000] 

interval = [0 -1 -1 

1 1-1 
0 1 0]; 


bwhiftmiss 





bw2 


bwhitmiss(bw,interval) 


bw2 = 


口 口 口 口 口 吕 
二 
0 
口 口 口 口 盖 吕 
口 口 口 一 口 口 
一 


See Also imdilate, imerode, strel 
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PurPpose 


Syntax 


Descripfion 


Remarks 


Class Suppor 


Remarks 


Example 
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Label connected components in a binary image 


L = bwlabel(BW,n) 
[L,num] = bwlabel(BW,n) 


L = bwlabel(BW,n) returnsamatrixL,ofthe same size as BW, containing labels 
for the connected objects in BW. n can have a value of either 4 or 8, where 4 
specifies 4-connected objects and 8 specifies 8-connected objects; 让 the 
argument is omijtted, it defaults to 8. 


The elements of L are integer values greater than or equal to 0. The pixels 
labeled 0 are the background. The pixels labeled 1 make up one object, the 
pixels labeled 2 make up a second object, and so on. 


[L,num] = bwlabel(BW,n) returns in num the number of connected objects 
found in BW. 


bwlabel Supports 2-D inputs only; bwlabeln Supports inputs of any dimension. 
In some cases, you might prefer to use bwlabeln even for 2-D problems because 
it can be faster. 玉 you have a 2-D input whose objects are relatively "thick' in 
the vertical direction, bwlabel will probably be faster; otherwise bwLlabeln will 
probably be faster. 


BW can be logical or numeric, and it must be real, 2-D, and nonsparse. Lis of 
class doub1e. 


You can use the MATLAB find function in conjunction with bwlabel to return 
Vectors of indqices for the pixels that make up a specific object. For example, to 
return the coordinates for the pixels in object 2 


[r,c]l = find(bwlabel(BW)==2) 


Youcan displaytheoutputmatrix asapseudo-color indexed image. 了 ach object 
appears in a different color, so the objects are easier to distinguish than in the 
original imnage. See label2rgb for more information. 


This example illustrates using 4-connected objects. Notice objects 2 and 3; with 
8-connected labeling, bwlabel would considqer these a single object rather than 
two separate objects. 


bwlabel 





BW = [1 1 1 0 0 0 0 0 
1 1 1 0 1 1 0 0 
1 1 1 0 1 1 0 0 
1 1 1 0 0 0 1 0 
1 1 1 0 0 0 1 0 
1 1 1 0 0 0 1 0 
1 1 1 0 0 1 1 0 
1 1 1 0 0 0 0 0] ; 
L = bwlabel(BW,4) 
4 一 
1 1 1 0 0 0 0 0 
1 1 1 0 2 2 0 0 
1 1 1 0 2 2 0 0 
1 1 1 0 0 0 3 0 
1 1 1 0 0 0 3 0 
1 1 1 0 0 0 3 0 
1 1 1 0 0 3 3 0 
1 1 1 0 0 0 0 0 
[rcl = find(L==2) ; 
rc = [rocl 
rc = 
2 5 
3 5 
2 6 
3 6 
Algorithm bwlabel uses the general procedure outlined in reference [J, pp. 40-48: 


Run-length encode the input image, 


2 Scan the runs, assigning preliminary labels and recording label 
equivalences in a local equivalence table. 


3 Resolve the equivalence classes. 
4 Relabel the runs based on the resolved equivalence classes. 
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See Also bweuler, bwlabeln, bwselect, Label2rgb 


Reference [II Haralick, Robert M., and Linda G. Shapiro. Comzpzter aq Robpot Visio7， 
Volxme 了 Addison-Wesley, 1992. pp. 28-48. 
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Purpose 


Synftax 


Descripfion 


Label connected components in N-D binary image 


L = bwlabeln(BW) 
[LNUM] = bwlabeln(BW) 
[LNUM] = bwlabeln(BW,CONN) 


L = bwlabeln(BW) returns alabel matrix, L, containing labels for the connected 
components in BW. BW can have any dimension; L is the same size as BW. The 
elements of L are integer values greater than or equal to 0. The pixels labeled 
0 are the background. The pixels labeled 1 make up one object, the pixels 
labeled 2 make up a second object, and so on. The default connectivity is 8 for 
two dimensions, 26 for three dimensions, and conndef (ndims(BW) ， 

'maximal' ) for higher qimensions. 


[L;,NUM] = bwlabeln(BW) returns in NUMthe number ofconnected objects found 
in BW. 


[L;,NUM] = bwlabeln(BW,CONN) specifies the desired connectivity. CONN may 
have any ofthe following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may also be defined in a more general way for any dimension by 
using for CONN a 3-by-3-by- .…-by-3 matrix of 0's and 1S. The 1-valued elements 
define neighborhood locationgs relative to the center element of CONN. Note that 
CONN must be symmetric about its center element. 
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Remarks 


Class Suppor 


Example 


Algorithm 
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bwlabel Supports 2-D inputs only; bwlabeln supports inputs of any dimension . 
In some cases, you might prefer to use bwlabeln even for 2-D problems because 
it can be faster. 玉 you have a 2-D input whose objects are relatively "thick' imn 
the vertical direction, bwlabel will probably be faster; otherwise bwLlabeln will 
probably be faster. 


BW can be numeric or logical, and ti must be real and nonsparse. Lis of class 
doub1e. 


BW = cat(3,[110;000;100],，..， 
[010;000;010]， 
[011;000;001]) 
bwlabeln(BW) 
ans(:,:,1) = 

1 1 0 

0 0 0 

2 0 0 
ans(:,:),2) = 

0 1 0 

0 0 0 

0 2 0 
ans(:,:),3) = 

0 1 1 

0 0 0 

0 0 2 


bwlabeln uses the following general procedure: 


1 Scan all image pixels, assigning preliminary labels to nonzero pixels and 
recording label equivalences in a union-find table. 


bwlabeln 





2 Resolve the equivalence classes using the union-find algorithm [ 革 ]. 
3 Relabel the pixels based on the resolved equivalence classes. 


See Also bwlabe1l, label2rgb 
Reference [1 Robert Sedgewick, ALsorztnms IC, 3rd ed., Addison-Wesley, 1998, pp. 
1I1-20. 
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PurPpose Perform morphological operations on binary images 


Syntax BW2 = bwmorph(BW1,operationm) 
BW2 = bwmorph(BW1 ,operatIonyn) 


Description BW2 = bwmorph(BW1,operatIzon) applies a specific morphological operation to 
the binary image BW1. 


BW2 = bwmorph(BW1,operation;n) applies the operation ntimes. n can be Inf， 
in which case the operation is repeated until the image no longer changes. 


operation is a string that can have one ofthe values listed below. 





"bothat “erode 'Shrink， 
bridge 于 11， '"“Skel， 
“Clean 'hbreak SPUr” 
"Cl1ose majority 七 hicken 
“diag "0pen 十 hin' 
“dilate， “Femove 七 ophat 





'bothat '(“bottom hat”) performs morphological closing (dilation followed by 
erosion) and subtracts the original image. 


'bridge' bridges previously unconnected pixels. For example， 


1 0 0 1 0 0 
1 0 1 becomes 1 1 1 
0 0 1 0 0 1 


'clean' removes isolated pixels (individual ls that are Surrounded by 0'S)， 
Such as the center pixel in this pattern, 


0 0 0 
0 1 0 
0 0 0 


'close' performs morphological closing (qilation followed by erosion). 
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'diag' uses diagonal fl to eliminate 8-connectivity of the background. For 
example， 


becomes 


口 一 吕 
口 口 一 
口 口 吕 
口 一 口 
3 
口 口 吕 


'dilate' performs dilation using the structuring element ones (3 ). 
'erode' performs erosion using the structuring element ones (3 ). 


'fil1' flls isolated interior pixels (individual 0's that are Surrounded by 1"S)， 
Such as the center pixel in this pattern, 


'hbreak' removes 再 -connected pixels. For example， 


P 
二 


1 1 1 
0 1 0 becomes 0 
1 1 1 


'majority' sets a pixel to 1 过 five or more pixels in its 3-by-3 neighborhood are 
1s; otherwise, it sets the pixel to 0. 


'open' imnplements morphological opening (erosion followed by dilation). 


remove ' removes interior pixels. This option sets a pixel to 0 让 all of its 
4-connected neighbors are 1, thus leaving only the boundary pixels on. 


'shrink' ,withn= Inf, shrinks objects to points. It removes pixels so that 
objects without holes shrink to a point, and objects with holes shrink to a 
connected ring halfway between each hole and the outer boundary. This option 
preserves the 了 Euler number. 


'skel' ,with n = Inf, removes pixels on the boundaries of objects but does not 
allow objects to break apart. The pixels remaining make up the image skeleton. 
This option preserves the Euler number. 


'Spur' removes Spur pixels. For example， 


0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 
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Class Supporf 


Example 
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0 becomes 
1 
1 


口 口 一 


0 0 0 
0 0 1 
0 1 1 


7 


'thicken', with n = Inf, thickens objects by adding pixels to the exterior of 
objects until doing so would result in previously unconnected objects being 
8-connected. This option preserves the Euler number. 


'thin' ,with n = Inf,thins objects to lines. It removes pixels so that an object 
without holes shrinks toaminimally connected stroke, and an object with holes 
shrinks to a connected ringhalfway between each hole and the outer boundary, 
This option preserves the Euler number. 


'tophat '〈(“top hat2) returns the image minus the morphological opening ofthe 


image. 


The input image BW1 can be numeric or logical. It must be 2-D, real and 
nonsparse. The output image BW2 is of class 1ogical. 


BW1 = imread( ' circles.tif ' ) ; 
Imshow(BW1 ) ; 





BW2 = bwmorph(BW1，remove ) ; 
BW3 = bwmorph(BW1，skel ,Inf); 
imshow(BW2 ) 
figure，imshow(BW3) 


口 口 吕 


bwmorph 








See Also bweuJler, bwperim, dilate, erode 


References [Haralick, Robert M., and Linda G. Shapiro. Comzpxter aa Robpot Visio7， 
Volx1e 了 Addison-Wesley, 1992. 


[2] Pratt，William 开 . Digzta! 7aasge Process115. John Wiley & Sons, Inc., 19911. 
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PurPpose 
Syntax 


Descripfion 
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Pack binary image 
BWP = bwpack(BW) 


BWP = bwpack(BW) packs the uint8 binary image BW into the uint32 array BWP， 
which is known as apacpea iary 1I7zage. Because each 8-bit pixel value in the 
binary image has only two possible values, 1 and 0, bwpack can map each pixel 
to a single bit in the packed output image. 


bwpack processesgs the image pixels by column, mapping groups of 32 pixels into 
the bits ofa uint32 value. The first pixel in the first row corresponds to the 
least significant bit ofthe first uint32 element of the output array. The first 
pixel in the 32nd input row corresponds to the most significant bit ofthis same 
element. The first pixel ofthe 33rd row corresponds to the least significant bit 
of the second output element, and so on. If BW is M-by-N, then BWP is 
ceil(M/32)-by-N. This fgure illustrates how bwpack maps the pixels in a 
binary image to the bits in a packed binary imasge. 


Input Image (each pixel is uint8 volue) 









Output Arroy 32 bis 








32 rows 


0 量 0EIIOUETSIEOEE 人 WE 下 二 
































bwpack 





Binary image packing is used to accelerate some binary morphological 
operations, Such as dilation and erosion. Ifthe inputto imdilate or imerode is 
a packed binary image, the functions use a specialized routine to perform the 
operation faster. 


bwunpack is used to unpack packed binary images. 


Class Support  。 Bw can belogical or numeric, and it must be 2-D, real, and nonsparse. BWP is of 
class Uint32. 
Example Pack, dilate, and unpack a binary image: 


bw = imread( text.tif ' ) ; 

bwp = bwpack(bw) ; 

bwp_dilated = imdilate(bwp,ones(3,3)，ispacked ) ; 
bw _ dilated = bwunpack(bwp_ dilated，sSize(bw,1)); 


See Also bwunpack, imdilate, imerode 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 
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Find perimeter pixels in binary image 


BW2 = bwperim(BW1) 
BW2 = bwperim(BW1 ,CONN) 


BW2 = bwperim(BW1) returns a binary image containing only the perimeter 
pixels of objects in the input image BW1. A pixel is part of the perimeter 计 it is 
Donzero and it is connected to at least one zero-valued pixel. The default 
connectivity is 4 for two dimensions, 6 for three dimensions, and 
conndef(ndims(BW) ，'minimal') for higher dimensions. 


BW2 = bwperim(BW1,CONN) specifies the desired connectivity. CONN may have 
any ofthe following scalar values. 





Value Meaning 





Two-dimensional connecfivities 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborphood 
26 26-connected neighborhood 





Connectivity may also be defined in a more general way for any dimension by 
using for CONN a 3-by-3-by-…-by-3 matrix of 0s and 1'S. The 1-valued elements 
define neighborhood locationgs relative to the center element of CONN. Note that 
CONN must be symmetric about its center element. 


BW1 must be logical or numeric, and it must be nonsparse. BW2 is of clasgs 
10gical. 


BW1 = imread(' circbw.tif ' ) ; 
BW2 = bwperim(BW1 ,8) ; 
Imshow(BW1 ) 


bwperim 





figure，imshow(BW2 ) 





See Also bwarea, bweuler, bwfil1, conndef 
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PurPpose 


Syntax 


Descripfion 


Example 
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Select objects in a binary image 


BW2 = bwselect(BW1,cryon) 
BW2 = bwselect(BW1,n) 
[BW2 ,1Idx] = bwselect(...) 


BW2 = bwselect(x,y;，BW1,xi,yiyny) 
[x,y,BW2,idx,Xxi,yi]l = bwselect(...) 


BW2 = bwselect(BW1,c,rin) returns a binary image containing the objects 
that overlap the pixel (rc). rand c can be scalars or equal-length vectors. Ifr 
and c are vectors, BW2 contaings the sets of objects overlapping with any of the 
pixels (Fr(k),c(k)).ncanhaveavalue ofeither 4or 8 (the default), where 4 
specifies 4-connected objects and 8 specifies 8-connected objects. Objects are 
connected sets of on pixels (i.e., pixels having a value of 1). 


BW2 = bwselect(BW1,n) displays the image BW1 on the Screen and lets you 
select the (Fr,c) coordinates using the mouse. Ifyou omit BW1, bwselect 
operates on the image in the current axes. Use normal button clicks to add 
points. Pressing Backspace or Delete removes the previously selected point. A 
shift-click, right-click, or double-click selects the final point; pressing Return 
finishes the selection without adding a point. 


[BW2,idx] = bwselect(...)returnsthe linear indices ofthe pixels belonging 
to the selected objects. 


BW2 = bwselect(x,y,BW1,xi,yiin) uses the vectors x and y to establish a 
nondefault spatial coordinate System for BW1. xi and yi are Scalars or 
equal-length vectors that specify locationgs in this coordinate System 


[x,y,BW2,idx,xi,yi]l = bwselect(...) returnstheXDataandYDatain xand 
yi; the output image in BW2; linear indices of all the pixels belonging to the 
Selected objects in idx; and the specified spatial coordinates in xi and yi. 


If bwselect is called with no output arguments, the resulting image is 
displayed in anevw figure. 


BW1 = imread( text.tif' ) ; 
c = [16 90 144] ; 
FF = [85 197 247] | 


bwselecf 





BW2 = bwselect(BW1,cr4) ; 
imshow(BW1 ) 
figure，imshow(BW2 ) 


Crfross-Cotrelation Used 
ToLocate 和 类 nhowt 
Tareget in an Image 





5b0 
耻 
4 
对 山口 
呈 总 己 
凶 马 召 
) 
员 妃 包 
已 忆 
书局 白 


Class Support The input image, BW1, can be logical or numeric and must be 2-D and 
nonsparse. The output image, BW2, is of class 1ogical. 


See Also bwfil1l1, bwlabel1,， impixel, roIipoly, roifil1 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 
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Ultimate erosion 


BW2 = bwulterode(BW) 
BW2 = bwulterode(BW,METHOD ,CONN ) 


BW2 = bwulterode(BW) computes the ultimate erosion ofthe binary image BW. 
The ultimate erosion of BW consists ofthe regional maxima ofthe Euclidean 
distance transform of the complement of BW. The default connectivity for 
computing the regional maxima is 8 for two dimensions, 26 for three 
dimensions, and conndef(ndims(BW) ， 'maximal') for higher dimensions. 


BW2 = bwulterode(BW,METHOD,CONN) specifies the distance transform method 
and the regional maxima connectivity. METHOD can be one of the strings 
'euclidean '，'cityblock' ，'chessboard ,or 'quasi-euclidean . 


CONN may have any of the following scalar values. 





Value Meaning 





Two-dimensional connectivities 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by.… - by-3 matrix of 0's and 1”"s. The 1-valued elements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


BW can be numeric or logical and it must be nonsparse. It can have any 
dmension. The return value, BW2, is always a logical array、. 


bwulferode 





Example bw = imread('circles.tif' ) 
imshow(bw)，title(' original ') 
bw2 = bwulterode(bw) ; 
figure，imshow(bw2)，title(' ULtimate erosion ) 


See Also bwdist, conndef, imregionalmax 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 
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Unpack binary image 
BW = bwunpack(BWP ,M) 


BW = bwunpack(BWP,M) unpacks the packed binary image BWP. BWP is a uint32 
arTray. When it unpacks BWP, bwunpack maps the least significant bit ofthe first 
row of BWP to the first pixel in the first row of BW. The most significant bit ofthe 
first element of BWP maps to the first pixel in the 32nd row of BW, and so on. BW 
is M-by-N, where N is the number of columns of BWP. If Mis omijitted, its default 
value is 32*size(BWP ,1). 


Binary image packing is used to accelerate some binary morphological 
operations, Such as dilation and erosion. Ifthe inputto imdilate or imerode is 
a packed binary image, the functions use a specialized routine to perform the 
operation faster. 


bwpack is used to create packed binary images. 
BWP is of class uint32 and must be real, 2-D, and nonsparse. The return value， 
BW, is of class Uint8. 


Pack, qilate, and unpack a binary image. 


bw = imread( text.tif ' ) ; 

bwp = bwpack(bw) ; 

bwp_dilated = imdilate(bwp,ones(3,3)，ispacked  ) ; 
bw dilated = bwunpack(bwp_dilated，Size(bw,1) ); 


bwpack，imdilate，imerode 


checkerboard 





Purpose Create checkerboard image 
Synftax I = checkerboard 
I = checkerboard(N) 


I = checkerboard(N,P,Q) 


Descripfion I = checkerboard creates a 8-by-8 square checkerboard image that has four 
identifiable corners. 了 ach square has 10 pixels per side. The light squares on 
the left halfofthe checkerboard are white. The light squares on the right half 
of the checkerboard are gray. 


I = checkerboard(N) creates a checkerboard image where each square has N 
pixels per side. 


I = checkerboard(N,P,Q) creates a rectangular checkerboard, where P 
specifies the number ofrows and Q specifies the number of columns. 了 ach row 
and column is made up of tiles. Each tile contaings four squares, N pixels per 
Side, defined as: 


TILE = [DARK LIGHT; LIGHT DARKI] 图 呈 


Ifyou omit Q, it defaults to P and the checkerboard is square 


Example Create a checkerboard where the side of every square is 20 pixels in length. 


I = checkerboard(20) ; 
Imshow(I) 





Create a 2-by-3 rectangular checkerboard. 


J = checkerboard(20,2,3) 
figure，imshow(JU ) 
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Create a black and white checkerboard. 


K = (checkerboard > 0.5) ; 
figure，imshow(K) 


See Also cp2tform, imtransform, maketform 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


See Also 


Rearrange the colors in a colormap 


[Y,newmap] = cmpermute(X,map) 
[Y,newmap] = cmpermute(X,map,index) 


[Y,newmap] = cmpermute(X,map) randomly reorders the colors in map to 
produce a new colormap newmap. The cmpermute function also modifies the 
values in Xto maintain correspondence between the indices and the colormap， 
and returns the result in Y. The image Y and associated colormap newmap 
produce the same image as X and map. 


[Y,newmap] = cmpermute(X,map,index) uses an ordering matrix (Such as the 


second output of sort) to define the order of colors in the new colormap. 


The input image Xcanbe ofclass uint8 or double.Yis returned as an arTay of 
the same class as X. 


To arrange a colormap in order by luminance, use 


ntsSc = rgb2ntsc(map ) ; 
[dum, index]l = Sort(ntsc(:，1)); 
[Y,newmap] = cmpermute(X,map,index ) ; 


randperm, sort in the MATLAB Function Reference 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


See Also 
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Find unique colormap colors and the corresponding image 


[Y,newmap] = cmunique(X,map) 
[Y,newmap] = cmunique(RGB) 
[Y,newmap] = cmunique(I) 


[Y,newmap] = cmunique(X,map) returns the indexed image Y and associated 
colormap newmap that produce the same image as (X,map) but with the 
smallest possible colormap. The cmunique function removes duplicate rowsg 
位 om the colormap and adjusts the indices in the image matrix accordingly. 


[Y,newmap] = cmunique(RGB) converts the truecolor image RGB to the indexed 
image Y and its associated colormap newmap. The return value, newmap, is the 
smallest possible colormap for the image, containing one entry for each unique 
color in RGB. (Note that newmap may be very large, because the number of 
entries can be as many as the number of pixels in RGB.) 


[Y,newmap] = cmunique(I) converts the intensity image Ito an indexed image 
Yand its associated colormap newmap. The return value, newmap, is the smallest 
possible colormap for the image, containing one entry for each unique intengsity 
level in 工 . 


The input image can be ofclass uint8, uint16, or double. The class ofthe 
output imageyYis uint8 ifthe length ofnewmap is less than or equal to 256. 开 
the length of newmap is greater than 256, Y is of class doub1e. 


gray2ind, rgb2ind 


col2im 





Purpose 


Syntax 


Descripfion 


Class Suppor 


See Also 


Rearrange matrix columns into blocks 


A = col2im(B,[mn]l, [mm nn]，bJock _ type) 
A = col2im(B,[mnl,[mm nn]) 


col2imrearranges matrix columns into blocks. bJock_type is a string with one 
of these values: 

e 'distinct' for m-by-n distinct blocks 

e 'Sliding' for m-by-n slidqing blocks (default) 

A = col2im(B,[m nl,[mm nn]，distinct') rearranges each column ofB 
into a distinct m-by-n block to create the matrixA of size mm-by-nn. 工 


B = [A11(:) A12(:) A21(:) A22(:)],where each column has length mxn， 
thenA = [A11 A12;A21 A22] where each Aij is m-by-n. 


A = col2im(B,[m nl,[mm nn]，sliding') rearranges the row vector B 
into amatrix ofsize (mm-m+1)-by-(nn-n+1).Bmustbe avector ofsize 
1-by-(mm-m+1)*(nn-n+1).Bis usually the result ofprocessing the output of 
im2col(...，'sliding') using acolumn compression function (Such as sum). 


A = col2im(B,[m n]l,[mm nn]) uses the default block type of 'sLliding '. 
B can be logical or numeric. The return value, A, js of the same class as B. 


blkproc, CoOLfilt，im2col, nLfilter 
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PurPpose 


Syntax 


Descripfion 
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Perform neighborhood operations Using column-wise functions 


= ColLfilt(A, [mn],bJock typefun) 

colfilt(A,[m n]l,byock _ type,fun,P1,P2,..,) 

= ColLfilt(A,[mn]l,[mblock nblock],bJIock type fun,，...) 
colfilt(A，indexed ，...,) 


四 四 男 四 


colfilt processes distinct or sliding blocks as columns. colfilt can perform 
similar operationgs to blkproc and nlL1filter, but often executes much faster. 


B = colfilt(A,[mn],bIock _ type,fun) processes the image Abyrearranging 
each m-by-n block of A into a column of a temporary matrix, and then applying 
the function fun to this matrix. fun can be a function_handle, created Using 
Q@, or an inline object. colfilt zero pads A, 让 necesSsary. 


Before calling fun, colfilt calls im2col to create the temporary matrix. After 
calling fun, colfilt rearranges the columns ofthe matrix back into m-by-n 
blocks using co12im. 


bJIock_type is a string with one ofthese values: 


e 'distinct' for m-by-n distinct blocks 
e 'Sliding' for m-by-n sliding neighborhoods 


B = colfilt(A,[mn]l,'distinct' ,fun) rearranges each m-by-n distinct blocK 
of Ainto a column in a temporary matrix, and then applies the function fun to 
this matrix. fun must return a matrix ofthe same size as the temporary 
matrix. coLfilt then rearranges the columns of the matrix returned by fun 
into m-by-n distinct blocks. 


B = colfilt(A,[m n]，sliding',fun) rearranges each m-by-n slidqing 
neighborhood of A into a column in a temporary matrix, and then applies the 
fanction fun to this matrix. fun must return a Tow Vector containing a Single 
value for each column in the temporary matrix. (Column compression functionsg 
Such as sum return the appropriate type of output.) coLIfilt then rearranges 
the vector returned by fun into a matrix of the same Size as A. 


B = colfilt(A,[m n],bIock _ type,fun,P1,P2,...) passes the additional 
parameters P1,P2,...,tofun.The colfilt fanction calls fun using， 


yY = fun(x;，P1,P2,...) 


colfi 寺 





Class Suppor 


Example 


See Also 


where x is the temporary matrix before processing, and y is the temporary 
matrix after processing. 


B = colfilt(A,[mn]l,[mblock nblock],bIock type,fun,...) processes the 
matrixA as above, but in blocks ofsize mblock-by-nblock to save memory. Note 
that using the [mblock nblock] argument does not change the result ofthe 
operation. 


B = colfilt(A，indexed',...) processes Aas an indexed imnage, padding 


with zerogs ifthe class ofAlis uint8 or uint16, or ones ifthe class ofAis doub1e. 


The input image Acan be ofany class Supported by fun. The class of B depends 
on the class ofthe output from fun. 


This example sets each output pixel to the mean value of the input pixels 
5-by-5 neighborhood. 


II = imnread( tire.tif ') 

imshow(I) 

I2 = Uint8(colfilt(I,[5 5]，Ssliding' ,emean) ) ; 
figure，imshow(I2) 


bl1kproc, coO01L2im,， im2col, nlLfilter 
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Purpose Display a colorbar 


colorbar jg a MATLAB function. To get help for this fonction, select MATLAB 
Help 们 om the Help menu and view the online function reference page. 
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Purpose 
Syntax 


Descripfion 


Examples 


Create connectivity array 
CONN = conndef(NUM_DIMS ,TYPE ) 
CONN = conndef(NUM_DIMS ,TYPE) returns the connectivity array defined by 


TYPE for NUM_DIMS dimensions. TYPE can have either ofthe values listed in this 
table. 





'minimal' Defines a neighborhood whose neighbors are touching the 
central element on an (N-1)-qimensional Surface, for the 
N-dqimensional case. See 了 Examples for an illustration. 


'maximal'， Defines a neighborhood including neighbors that touch the 
central element in any wayi it ig 
ones(repmat(3,1;,NUM_DIMS) ). See Examples for an 
illustration. 





Several Image Processing Toolbox functions use conndef to create the default 
connectivity Input argument， 


The minimal connectivity array for two dimensions includes the neighbors 
touching the central element along a line. 
conn1 = conndef(2，minimal ') 
conn1 = 
0 1 0 


1 1 1 
0 1 0 


The minimal connectivity array for three dimensiongs includes all the neighbors 
touching the central element along a face. 


conndef(3，minimal ) 


ans(:,:,1) = 
0 0 0 
0 1 0 
0 0 0 
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ans(:,:),2) = 
0 1 0 
1 1 1 
0 1 0 
ans(:,:),3) = 
0 0 0 
0 1 0 
0 0 0 


The maximal connectivity array for two dimensiongs includes all the neighbors 
touching the central element in any way， 


conn2 = conndef(2，maximal ) 


Conn2 
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Purpose Perform two-qimensional convolution 


conv2 is a function in MATLAB. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference page. 
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PurPpose Compute two-dqimensional convolution matriX 


Synftax T 


Convmtx2(H;,my;n) 
convmtx2(H,[m nl]) 


Description T = convmtx2(H,m,n) orT = convmtx2(H,[m n] ) returngs the 
convolution matrix T for the matrix H. 开 X is an m-by-n matrix, then 
reshape(Tx*X(:),size(H)+[m n]-1) isthe same as conv2(X,H). 


Class Support The inputs are all of class double. The output matrix Tis of class sparse. The 
number ofnonzero elements in Tis no larger than prod(size(H) )*xmxn， 


See Also conv2 


convmtx in the Si57Pal Processins TooLbox User's Guiae 


14-76 


COnVn 





Purpose Perform N-dqimensional convolution 


convn jg a MATLAB function. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference page. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Algorithm 


See Also 
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Compute the two-dimensional correlation coefficient between two matricegs 


王 


= Corr2(A,B) 


F = corr2(A,B) computes the correlation coe 值 cient between A and B, where A 
and B are matrices or vectors of the Same Size. 


Aand B can be numeric or logical. The return value, r, is a scalar doub1le. 
corr2 computes the correlation coefficient using 


1 也 


ze me 





where 4 = mean2(A), and 互 = mean2(B)， 


Std2 
corrcoef in the MATLAB Function Reference 


cp2ftform 





Purpose 


Syntax 


Descripfion 


Transform Type 


Infer geometric transformation 位 om control point pairs 


TFORM = cp2tform(input_points,base_pointsy transfommtype ) 

TFORM = cp2tform(CPSTRUCT transfommtype) 

TFORM = cp2tform(input_points,base_pointsy transforntype, parameter ) 

TFORM = cp2tform(CPSTRUCT transfommtypey parameter) 

[TFORM, input_points,base_points] = cp2tform(CPSTRUCT，,..) 

[TFORM, input_points,base_points,input _points_bad,base_points_bad ] 
= Cp2tform(...， piecewise Jinear ') 


TFORM = cp2tform(input_points,base _points,transformtype) takes pairs 
of control points and uses them to infer a spatial transformation. The function 
returns aTFORM structure containingthe spatialtransformation. input_points 
is an 70-by-2 double matrix containing thex andy coordinates ofcontrol points 
in the image you want to transform. base_points is an -by-2 double matriX 
containing thex andy coordinates of control points specified in the base image, 
The transformtype argument specifies the type oftransformation you want to 
infer. For more information about Supported types, see Transform Type. 


TFORM = cp2tform(CPSTRUCT,transformtype) passes a CPSTRUCT Structure 
that contains the control point matrices for the input and base images. The 
Control Point Selection Tool, cpselect, creates the CPSTRUCT. 


[TFORM, input_points,base _points] = cp2tform(CPSTRUCT,...) returnsthe 
control points that were actually used in input_points, and base_points. 
Unmatched and predicted points are not used. For more information, see 
cpstruct2pairs. 


transformtype specifies the type ofspatial transformation to infer. This table 
lists all ofthe transformation types Supported by cp2tform, in order of 
complexity. (See Algorithms for detailed information about each transform 
type.) The table includes the minimum number of control point pairs you must 
select for each type. The ' lwm' and 'polynomial' transform types can each 


14-79 


cp2ftform 





take an optional, addqitional parameter.See the syntax descriptions that follow 
for details. 





Transformaftion Type ”Description Minimum Example 
Contirol Points 


'1inear conformal” Use this transformation when 2 pairs 
shapes in the input image are 加 3 
unchanged, but the image is 
distorted by some combination of 
translation, rotation, and scaling. 

Straight lines remain straight, and 
parallel lines are still parallel. 


'affine' Use this transformation when 3 pairs 
shapes in the input image exhibit 性 、 
shearing. Straight lines remain 中 S 
straight, and parallel lnes remain 
parallel, but rectangles become 
parallelograms. 


'projective' Use this transformation when the 4 pairs 
Scene appears “tilted.”Straight \ 肖 
lines remain straight, but parallel 中 二 
lines converge toward “vanishing 
points”which may or may not fall 
within the image. 
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"polLynomial 


“piecewise 1Linear 


“ 工 Wm 


Use this transformation when 
objects in the image are curved. The 
higher the order of the polynomial， 
the better the fit, but the result can 
contain more curves than the base 
image. 


Use this transformation when parts 
ofthe image appear distorted 
differently. 


Use this transformation (local 
weighted mean), when the 
distortion varies locally and 
piecewise linear is not sufficient. 


6 palrs 
(order 2) 


唤 妇 


10 palrs 
(ordqer 3) 


16 palrs 
(order 4) 


4 palrs 


六 "这 
呈 绩 


6 palrs 
(12 palrs 
recommended) 








Nofte When transformtypeis 'Linear conformal'，'affine '， 
'projective' ,or 'polynomial', and input_points and base_points (or 


CPSTRUCT) have the minimum number of control points needed for a particular 
transformation, cp2tform finds the coefficients exactly If input_points and 
base_points include more than the minimum number ofpoints， cp2tform 
uses a least squares solution. For more information, see mLdivide. 





TFORM 
TFORM 


cp2tform(input_points,base_points，polynomial' ,ORDER ) 
cp2tform(CPSTRUCT ，polynomial ,order) 


When 'polynomial' is the transform type, youcan optionally specify the order 
of the polynomial to use. order can be the scalar value 2, 3, or 4. 开 you omit 
order, it defaults to 3. 


TFORM = cp2tform(input_points,base_points，1J1Lwm',N) 
TFORM = cp2tform(CPSTRUCT，1Lwm' ,NI) 

When '1lwm' is the transform type, you can optionally specify the number of 
points, N, used to infer each polynomial. The radius of influence extends out to 
the furthest control point usedto inferthatpolynomial. The N closest points are 
used to infer a polynomial of order 2 for each control point pair. Iyou omit N， 
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14-82 


it defaults to 12. N can be as small as 6, but making N small risks generating 
il-conditioned polynomials. 


[TFORM, input_points,base_points,input_points bad,base_points_bad ]= 
cp2tform(input_points,base_points，piecewise Linear ) 

[TFORM, Input_points,base_points,input_points_bad,base_points_bad ]= 
cp2tform(CPSTRUCT，piecewise Linear ') 

When 'piecewise linear' is the transform type, cp2tform can optionally 

return the control points that were actually used in input_points and 

base_points, and return two arrays, input_points_bad and 

base_points_bad, that contain control points that were eliminated because 

they were middle vertices of degenerate foldq-over triangles. 


cp2tform uses the following general procedure: 


1 Use valid pairs of control points to infer a spatial transformation or an 
inverse-mapping 位 om output space (X,y) to input space (Uv) according to 
transformtype. 


2 Return TFORM structure containing spatial transformation. 


The procedure varies depending on the transformtype. 


Linear Conformal 

Linear conformal transformations may include a rotation, a scaling, and a 
translation. Shapes and angles are preserved. Parallel lines remain parallel. 
Straight lines remain straight. 


Let: 
SC = Scale*cos(angle) 
SS = Scale*Sin(angle) 


[uvl]= [xy1l* [sc -ss 
SS SC 
tx ty] 


Solve for sc, ss, tx, ty. 


t_1lc = cp2tform(input_points,base_points，1Linear conformal ) ; 


The coefEGcients of the inverse mapping are stored in t_lc.tdata.Tinv. 
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Since linear conformal transformations are a Subset of affine trangsformations， 
t_lc.forward fcnis aaffine_fwdandt_ lc.inverse_fcnis Qaffine_inv. 


At least two control-point pairs are needed to solve for the four unknown 
coefficients. 


Affine 


In an affine transformation, the x and y qimensions can be scaled or Sheared 

independently and there may be atranslation. Parallel lines remain parallel. 
Straight lines remain straight. Linear conformal transformationgs are a Subset 
of afGne transformations. 


For an affine transformation: 

[uvl]= [xy1]l*Tinv 
Tinv is a 3-by-2 matrix. Solve for the 6 elements of Tinv. 

t_affine = cp2tform(input_points,base_points，affine ' ) ; 
The coefcients of the inverse mapping are stored in t_affine.tdata.Tinv. 
At least 3 control-point pairs are needed to solve for the 6 unknown coe 仁 cients. 
Proiecfive 
In a projective transformation, quadrilaterals map to quadrilaterals. Straight 


lines remain straight. AffGine transformations are a subset of projective 
transformations. 


For a projective transformation: 
[up vp wpl]= [xywl]l>*Tinv 
Where 


uU = Up/wp 
v = Vvp/wp 


Tinv is a 3-by-3 matrix. 


Assuming 


14-83 


cp2ftform 





CFII]; 


U= (Ax +By+C)/(CGx + Hy + 工 ) 
V= (Dx+EY + F)/(Gx + Hy + 工 ) 


Solve for the 9 elements of Tinv. 
t_proj = cp2tform(input_points,base_points，projective ) ; 
The coefEGcients of the inverse mapping are stored in t_proj .tdata.Tinv. 
At least 4 control-point pairs are needed to solve for the 9 unknown coefficients. 
Polynomial 


In a polynomial transformation, polynomial functions of x and y determine the 
mapping. 





Second-Order Polynomials 





For a second-order polynomial transformation: 
[uvl]= [1 x y xy Xx*2 y?*2] * Tinv 


Both u and v are second-order polynomials of x and y. 也 ach second-order 
polynomial has Six terms. To specify all coefficients, Tinv has Size 6-by-2. 


t_poly_ord2 = 
cp2tform(input_points,base_points，polynomial ) ; 


The coefficients ofthe inverse mapping are stored in t_poly_ord2 .tdata. 


At least 6 control-point pairs are needed to solve for the 12 unknown 
coefEGicients. 
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Third-Order Polynomials 
For a third-order polynomijal transformation: 

[UVvV]= [1 X yY Xxx*y X2?2 Vy?2 yx*xX^2 Xx*y^2 X^3 y?3] * Tinv 
Both u and v are third-order polynomijals of x and y. Each third-order 
polynomial has ten terms. To specify all coefEcients, Tinv has size 10-by-2. 


t_poly_ord3 = cp2tform(input_points，base_points， 
"polynomial ,3) ; 


The coefcients of the inverse mapping are stored in t_poly_ord3 .tdata. 


At least 10 control-point pairs are needed to solve for the 20 unknown 
coefficients. 








Fourth-Order Polynomials 
For a fourth-order polynomial transformation: 
[uv]= [1 xX yY xx*y X?2 y?2 yx*xe2 Xx*y^2 X*3 y?*3] * Tinv 


Both u and v are fourth-order polynomials of x and y. 了 ach fourth-order 
polynomial has fifteen terms. To specify all coefficients, Tinv has size 
15-by-2. 


t_poly_ord4 = cp2tform(input_points，base_points， 
“polynomial ,4) ; 


The coefcients of the inverse mapping are stored in t_poly_ord4.tdata. 


At least 15 control-point pairs are needed to solve for the 30 unknown 
coefficients. 





Piecewise Linear 


In a piecewise linear transformation, linear (affine) transformationgs are 
applied separately to each triangular region ofthe imasge []. 
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1 Find a Delaunay triangulation ofthe base control points. 


2 Using the 3 vertices of each triangle, infer an affine mapping 位 om base to 
input coordinates. 





Neofte At least 4 control-point pairs are needed. Four pairs result in two 
triangles with distinct mappings， 





Local Weighted Mean 


For each control point in base_points: 


Find the N closest control points. 

2 Use these N points and their corresponding points in input_points to infer 
a Second order polynomial. 

3 Calculate theradius ofinfluence ofthis polynomial as the distance 他 om the 
center control point to the furthest point used to infer the polynomial (using 
base_points). [2] 





Neote At least 6 control-point pairs are needed to solve for the second-order 
polynomial. Il-conditioned polynomials may result 过 too few pairs are used. 





I = checkerboard ; 

J = imrotate(I,30) 

base_points = [11 11; 41 71] ; 
input_points = [14 44; 70 81] ; 
cpselect(J,I,input_points,base_points ) ; 


t = cp2tform(input_points,base_points，1inear conformal  ) ; 


To recover angle and scale: 


SS = ttdata.Tinv(2,1); % SSs = Scale *x Sin(angle) 
SC = ttdata.Tinv(1,1); 上 5 Sc = Scale * coSs(angle) 
angle = atan2(Ss,Sc)*180/pi 
Scale = Sdqrt(SS*SS + SCxSC) 
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See Also cpcorr, cpselect, cpstruct2pairs, imtransform 


References [H] Ardqeshir Goshtasby, Piecewise linear mapping functions for image 
registration, Pautter7m Recosmz 友 oz, Vol 19, pp. 459-466, 1986. 


[2] Ardqeshir Goshtasby, Image registration by local approximation methods， 
77rase a7Q Visio7 Co7DVL1S, Vol 6, p. 255-261, 1988. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Algorithm 
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Tune control point locations using cross correlation 
input_points = cpcorr(input_points_in,base_points_in, Input,base) 


input_points = cpcorr(input_points_in,base_points_in,input,base) 
uses normalized cross-correlation to adjust each pair ofcontrol points specified 
in input_points_in and base_points_in. 


input_points_in must be an M-by-2 double matrix containing the coordinatesgs 
of control points in the input image. base_points_inis an M-by-2 double 
matrix containing the coordinates of control points in the base imasge. 


cpcorr returns the adqjusted control points in input_points, a doubple matrix 
the same size as input_points_in.Ifcpcorr cannot correlate apair of control 
points, input_points contains the same coordinates as input_points_in for 
that pair， 


cpcorr only moves the position of a control point by up to 4 pixels. Adjusted 
coordinates are accurate to one tenth of a pixel. cpcorr is designed to get 
Subpixel accuracy from the image content and coarse control point selection. 





Nofte input and base images must have the same scale for cpcorr to be 
effective. 





cpcorr cannot adjust a point 这 any ofthe following occur: 


e Points are too near the edge of either image 

e Regions of images around points contain Inf or NaN 

se Region around a point in input image has zero standard deviation 
e Regions of images around points are poorly correlated 


The images, input and base, can be ofclass 1ogical, uint8, uint16, or doub1le 
and must contain finite values. The control point pairs are of class doub1le. 


cpcorr uses the following general procedure， 


For each control point pair': 


cpPcorr 





Example 


See Also 


卫 xtract an 11-by-1ltemplate around the input control point and a 21-by-21 
region around the base control point. 


Calculate the normalized cross-correlation ofthe template with the region. 
Find the absolute peak ofthe cross-correlation matrix. 


Use the position ofthe peak to adjust the coordinates of the input control 
point. 


This example uses cpcorr to fine-tune control points selected in an image. Note 
the difference in the values ofthe input_points matrix and the 
input_points_adj matrixX. 


input = imread('` 1Lily.tif ); 

base = imread( ' flowers.tif ' ) ; 

Input_points = [127 93; 74 59] ; 

base_points = [323 195; 269 161] ; 

input_points adj = cpcorr(input_points,base_points，,.. 
input(:，:,1)，,base(:,:，,1)) 

input_points_adj = 


126.0000 “94.0000 
72.1000 60.0000 


cp2tform, cpselect, imtransform, normXxcorr2 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Algorithm 
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Control Point Selection Tool 


cpselect(input,base) 
cpselect(input,base,CPSTRUCT_IN ) 
cpselect(input,base,XYINPUT_IN,XYBASE_IN) 
H = cpselect(input,base,...,) 


cpselect(input,base) starts the Control Point Selection Tool, a graphical 
user interface that enables you to select control points in two related images. 
input is the image that needs to be warped to bring it into the coordinate 
System ofthe base image. input and base can be either variables that contain 
images or strings that identify files containing grayscale images. The Control 
Point Selection Tool returns the control points in a CPSTRUCT Structure. (For 
more information, see“Using the Control Point Selection Tool”in Chapter 5.) 


cpselect(input,base,CPSTRUCT_IN) starts cpselect with an initial set of 
control points that are stored in CPSTRUCT_IN. This syntax allows you to restart 
cpselect with the state of control points previously saved in CPSTRUCT_IN. 


cpselect(input,base,xyinput_in,xybase_in) starts cpselect with a set of 
initial pairs of control points. xyinput_in and xybase_in are 1-by-2 matrices 
that store the input and base coordinates, respectively. 


H = cpselect(input,base,...)returnsahandle Htothetool.Youcanusethe 
dispose(H) or H.dispose Syntaxesgs to close the tool 位 om the command line. 


The input images can be of class uint8, uint16, double, or 1ogical. 


cpselect uses the following general procedure for control point prediction. 


1 Find all valid pairs of control points. 


2 Infer aspatial transformation between input and base control points using 
method that depends on the number of valid pairs as followsg: 


2 palrs Linear conformal 
3 palrs Affine 
4or more palirs Projective 


cpselect 





Example 


See Also 


3 Apply spatial transformation to the nevw point to generate the predicted 
point. 


4 Display predicted point. 


Start tool with saved images. 


aerial = imread('westconcordaerial.png ) 
cpselect(aerial(:,:,1)，westconcordorthophoto.png  ) 


Start tool with workspace images and points. 


II = checkerboard ; 

J = imrotate(I ,30) 

base_points = [11 11; 41 71] 
input_points = [14 44; 70 81] ; 
cpselect(J,I,input_points,base_points ) ; 


cpcorr, cp2tform, cpstruct2pairs, imtransform 
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PurPpose Convert CPSTRUCT to valid pairs of control points 
Syntax [input_points，base_points] = cpstruct2pairs(CPSTRUCT ) 
Description [input_points，base_ points] = cpstruct2pairs(CPSTRUCT) takes a 


CPSTRUCT (produced by cpselect) and returns the arrays of coordinates ofvalid 
control point pairs in input_points and base_points. cpstruct2pairs 
eliminates unmatched points and predicted points. 


Example Start the Control Point Selection Tool, cpselect. 
CpSselect('1Li1ly.tif' ，flowers.tif ') 


Using cpselect, pick control points in the images. Select Save To Workspace 
位 om the File menu to save the points to the workspace. On the Save dialog 
box, check the Structure with all points checkbox and uncheck Input points 
and Base points. Click OK. Use cpstruct2pairs to extract the input and base 
points from the CPSTRUCT. 


[input_points,base_points] = cpstruct2pairs(cpstruct ) ; 


See Also cp2tform, cpselect, imtransform 
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Purpose 


Synftax 


Descripfion 


Class Suppor 


Algorithm 


Example 


Compute two-dimensional discrete cosine transform 


B = dct2(A) 
dct2(A;m,n) 
B = dct2(A,[mnl]) 


中 
中 


B = dct2(A) returns the two-dimensional discrete cosine transform of A. The 
matrix B is the same Size as A and contaings the qiscrete cosine transform 
coefficients 已 (5 K2) 


B = dct2(A;m;n) orB = dct2(A,[m n]) pads the matrix A with zerogs to size 
m-by-n before transforming. Ifmor n is smaller than the corresponding 
dimension ofA, dct2 truncates A. 


Acan be numeric or logical. The returned matrix, B, is of class doub1e. 


The discrete cosine transform (DCT) is closely related to the discrete Fourier 
transform. It is a separable, lnear transformation; that is, the 
two-dimensional transform is equivalent to a one-dimensional DCT performed 
along a single dimension followed by a one-dimensional DCT in the other 
dmension. The definition ofthetwo-dimensional DCT for an inputimageAand 
output image B 18 


上 -1N=-1 
Tr(2m+1)Dp FT(22+1) 0<sp<M- 
0 0<q<N-1 
=07=0 
人 2 
” LV37 开 1<p<M-1 7 VAN 1<<sN-1l 


where M and N are the row and column size ofA, respectively. Ifyou apply the 
DCT to real data, the result is also real. The DCT tends to concentrate 
information, making it useful for image compression applications, 


This transform can be inverted using idct2. 


The commands below compute the discrete cosine transform for the autumn 
image. Notice that most ofthe energy is in the upper left corner. 
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RGB = imread( autumn.tif ' ) ; 

I = rgb2gray(RGB ) ; 

J = dct2(I); 
imshow(1og(abs(JyJ)),[])，colormap(jet(64) )，colorbar 





Now set values less than magnitude 10 in the DCT matrix to zero, and then 
reconstruct the image using the inverse DCT function idct2. 


JU(abs(J) < 10) = 0; 
K = idct2(JU)/255; 
Imshow(K) 
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See Also fft2, idct2,， ifft2 


References [Jain, Anil 民 . Fz7aameptals of .DigSital 1age Processi1S5. Englewood Cliffs， 
NJ: Prentice Hall, 1989. pp. 150-153. 


[2] Pennebaker, William B., and Joan 工 . Mitchell. .PPEG: St Taase Data 
Compressiom Stamnadara. Van Nostrand Reinhold, 1993. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Remarks 


See Also 


14-96 


Compute discrete cosine transform matrix 
D = dctmtx(n) 


D = dctmtx(n) returns the n-by-n DCT (qiscrete cosine transform) matrix. Dx*A 
is theDCT ofthe columns ofA and D'*Ais the inverseDCT ofthe columns of A 
(when Ais n-by-n). 


n is an integer scalar of class double. D is returned as a matrix of class doub1e. 


HAis square, the two-dimensional DCT ofA can be computed as D*Ax*D'. Thigs 
computation is sometimes faster than using dct2, especially 让 you are 
computing a large number of small DCTs, because D needs to be determined 
only once. 


For example, in JPEG compression, the DCT of each 8-by-8 block is computed. 
To perform this computation, use dctmtx to determine D, and then calculate 
each DCT using D*Ax*D' (where Ais each 8-by-8 block). This is faster than 
calling dct2 for each individual block. 


dct2 
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Purpose 


Syntax 


Descripfion 


Restore image using the blind deconvolution algorithm 


[J,PSF] = deconvblind 
[J,PSF] = deconvblind 
[J,PSF] = deconvblind 
[J,PSF] = deconvblind 
[J,PSF] = deconvblind 
[J,PSF] = deconvblind 


I,INITPSF) 

I,INITPSF ,NUMIT) 
I,INITPSF,NUMIT,DAMPAR) 
I,INITPSF,NUMIT,DAMPAR ,WEIGHT) 
I,INITPSF,NUMIT,DAMPAR,WEIGHT,READOUT) 
..,,FUN,P1,P2,...,PN) 


AR 


[J,PSF] = deconvblind(I,INITPSF) deconvolves image Iusingthe maximum 
likelihood algorithm, returning both the deblurred image, J, and a restored 
point-spread function, PSF. The input array, TI, and your initial guess at the 
PSF, INITPSF, can be numeric arrays or cell arrays. (Use cell arrays when you 
want to be able to perform additional deconvolutions that start where youT 
initial deconvolution finished. See Resuming Deconvolution for more 
information.) The restored PSF is a positive array that is the same size ags 
INITPSF, normalized so its sum adds up to 1L. 





Nofte The PSF restoration is affected strongly by the size of the initial guess， 
INITPSF and less by the values it contains. For this reason, Specify an arTray of 
ones as yYOUT INITPSF. 





To improve the restoration, deconvb1lind Supports Several optional 
parameters, described below. Use [] as a place holder 让 you do not specify an 
intermediate parameter. 


[J,PSF] = deconvblind(I,INITPSF,NUMIT) specifies the number ofiterationgs 
(default is 10). 


[J,PSF] = deconvblind(I,INITPSF,NUMIT,DAMPAR) specifies the threshold 
deviation ofthe resulting image from the input image I (in terms ofthe 
standard deviation of Poisson noise) below which damping occurs. The 
iterationgs are Suppressed for the pixels that deviate within the DAMPAR value 
位 om their original value. This suppresses the noise generation in such pixels， 
preserving necessary image details elsewhere. The default value is 0 no 
damping). 
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[J,PSF] = deconvblind(I,INITPSF,NUMIT,DAMPAR,WEIGHT) specifies which 
pixels in the input image, I, are considered in the restoration. By defaujt， 
WEIGHT is aunit array, the same size as the input image.You can assign avalue 
between 0.0 and 1.0 to elements in the WEIGHT array. The value of an element 
in the WEIGHT array determines how much the pixel at the corresponding 
position in the input image is considered. For example, to exclude a pixel from 
consideration, assign it avalue of 0 in the WEIGHT array. You can adjust the 
weight value assigned to each pixel according to the amount of fat-field 
Correction . 


[J,PSF] = deconvb1lind(I,INITPSF,NUMIT,DAMPAR ,WEIGHT,READOUT) ,where 
READOUT is an array (or a value) corresponding to the additive noise (e.g.， 
background, foreground noise) and the variance ofthe read-out camera noise. 
READOUT has to be in the units of the image. The default value is 0. 


[J,PSF] = deconvblind(...,，FUN,P1,P2,...,PN), where FUN is a function 
describing additional constraints on the PSF. There are four ways to specify 
FUN: 

e Function handle (@) 

e Inline object 

e String containing fanction name 

e String containing a MATLAB expression 

FUN is called at the end of each iteration. FUN must accept the PSF as its first 
argument and can accept additional parameters P1, P2,. ..,， PN. The FUN 


fanction should return one argument, PSF, that is the same size as the original 
PSF and which satisfies the positivity and normalization constraints. 





Nofte The output image J could exhibit ringing introduced by the discrete 
Fourier transform used in the algorithm. To reduce the ringing useI = 
edgetaper(I,PSF) prior calling deconvb1lind. 





You can use deconvb1lind to perform a deconvolution that starts where a 
previous deconvolution stopped. To use this feature, pass the input image, LI， 
and the initial guess at the PSF, INITPSF, as cell arrays: {I} and {INITPSF1}. 
When you do, the deconvblind function returns the output image J and the 
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Class Suppor 


Example 


See Also 


restored point spread function, PSF, as cell arrays, which can then be passed as 
the input arrays into the next deconvblind call. The output cell array, J， 
contains four elements: 


J{1} contains I, the original image 

J{2} contaings the result ofthe last iteration 

J{3} contains the result of the next-to-last iteration 
J{4} is an array generated by the iterative algorithm 


I can be ofclass uint8, uint16, or doub1le. The DAMPAR and READOUT arguments 
have to be ofthe same class as the input image. Other inputs haveto be ofclass 
double.The output image, J, or the first array ofthe output cell array, is ofthe 
same class as the input image. 


I = checkerboard(8) 

PSF = fspecial('gaussian' ,7,10) ; 

V = .0001; 

BlurredNoisy = imnoise(imfilter(I,PSF)，gaussian' ,0,V) 

WT = zeros(Size(I) ) ; 

WT(5:end-4,5:end-4) = 1 

INITPSF = ones(Size(PSF) ) ; 

FUN = inline('PSF + P1'，PSF'，P1')， 

[J P]= deconvb1lind(BlurredNoisy,INITPSF,20,10*sqrt(V),WT,FUN,0) ; 


Subplot(221) ;imshow(BLurredNoiSsy ) ; 
title('A = Blurred and Noisy ) ; 
Subp1lot(222) ;imshow(PSF,[]); 
title(' True PSF ' ) ; 

Subplot(223) ;imshow(J) ; 

tit1le(' Deblured Image ' ) ; 
Subp1lot(224) ;imshow(P,[]); 

tit1le(' Recovered PSF ) ; 


deconvJlucy, deconvreg, deconvwnr, otf2psf, padarray, psSf2otf 
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PurPpose 


Syntax 


Descripfion 
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Restore image using the Lucy-Richardson algorithm 


= deconvlucy(I,PSF ) 

= deconvlucy(I,PSF ,NUMIT) 

= deconvlucy(I,PSF ,NUMIT ,DAMPAR ) 

= deconvlucy(I,PSF ,NUMIT ,DAMPAR ,READOUT ) 

= deconvlucy(I,PSF ,NUMIT, DAMPAR ,READOUT ,WEIGHT ) 
deconvlucy(I,PSF,NUMIT, DAMPAR ,READOUT ,WEIGHT ,SUBSMPL ) 


1 


J = deconvlucy(I,PSF) restores image I, degraded by convolution with a 
point-spread function, PSF, and possibly by additive noise. The algorithm is 
based on maximizing the likelihood ofthe resulting image J being an instance 
of the original image I under Poisson statistics. The input array, I, can be a 
numeric arTay or cell array. (Use a cell array when you want to be able to 
perform additional deconvolutions that start where your initial deconvolution 
finished. See Resuming Deconvolution for more information.) 


To improve the restoration, deconvlucy Supports several optional parameters, 
Use [] as a place holder 让 you do not specify an intermediate parameter. 


J = deconvlucy(I,PSF,NUMIT) specifies the number of iterations the 
deconvlucy function performs. Ifthis value is not specified, the default is 10. 


J = deconvlucy(I,PSF,NUMIT,DAMPAR) specifies the threshold deviation ofthe 
resulting imnage from the image I(in terms ofthe standard deviation ofPoisson 
noise), below which damping occurs. Iterationgs are Suppressed for pixels that 
deviate beyond the DAMPAR value from their original value. This suppresses the 
noise generation in Such pixels, preserving necessary image details elsewhere. 
The default value is 0 no damping). 


J = deconvlucy(I,PSF,NUMIT,DAMPAR,WEIGHT) specifies the weight to be 
assigned to each pixelto reflect its recording quality in the camera. Abad pixel 
is excluded 他 om the solution by assigning it zero weight value. Instead of 
giving a weight ofunity for good pixels, one could adqjusttheir weight according 
to the amount of flat-field correction. The default is a unit array of the same 
Silze as input Image 工 . 


J = deconvlucy(I,PSF,NUMIT,DAMPAR,WEIGHT,READOUT) specifies a value 
corresponding to the additive noise (e.g., background, foreground noise) and 


deconvlucy 





Resuming 
Deconvolution 


Class Suppor 


Example 


the variance ofthe read-out camera noise. READOUT has to be in the units of the 
image. The default value is 0. 


J = deconvlucy(I,PSF,NUMIT,DAMPAR,WEIGHT ,READOUT,SUBSMPL)，where 
SUBSMPL denotes subsampling and is used when the PSF is given on a grid that 
is SUBSMPL times finer than the image. The default value is 1. 





Nofte The output image J could exhibit ringing introduced by the discrete 
Fourier transform used in the algorithm. To reduce the ringing useI = 
edgetaper(I,PSF) prior calling deconv1Lucy. 





Ifinput Iis a cell array, the output J becomes a cell array of size 1-by-4, where 


J{1} contains I, the original image 

J{2} contaings the result ofthe last iteration 

J{3} contains the result of the next-to-last iteration 
J{4} is an array generated by the iterative algorithm 


The input cell array could contain one numerical array (the blurred image), or 
four numerical arrays ifit was the output 位 om the previous run ofdeconv1Lucy， 


Ican be ofclass uint8, uint16, or doub1le. The DAMPAR and READOUT arguments 
have to be ofthe same class as the input image. Other inputs haveto be ofclass 
double. Output image (or the first array of the output cell) is ofthe same classg 
as the input image， 


I = checkerboard(8) 

PSF = fspecial('gaussian ,7,10) ; 

V = .0001; 

BlurredNoisy = imnoise(imfilter(I,PSF)，gaussian ,0,V) ; 
WT = zeros(Size(I) ) ; 

WT(5:end-4,5:end-4) = 1 

J1 = deconvlucy(BlLurredNoisy ,PSF ) ; 

Jd2 = deconvlucy(BlLlurredNoisy,PSF,20,Sdqrt(V) ) ; 

Jd3 = deconvlucy(BlLlurredNoisy,PSF,20,Sqrt(V)，[],WT) 


Subplot(221) ;imshow(BLurredNoisy ) ; 
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title('A= Blurred and Nolisy ) 
Subp1lot(222) ;imshow(J1) ; 

tit1le(' deconvlucy(A,PSF) ) 
Subplot(223) ;imshow(J2) ; 

tit1le( deconvlucy(A,PSF ,NI,DP) ) ; 
Subp1lot(224) ;imshow(J3) ; 
title('deconvlucy(A,PSF,NI,DP,[],WT) '); 


See Also deconvb1lind, deconvreg, deconvwnr, otf2psf, padarray, pSf2otf 
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Purpose 


Syntax 


Descripfion 


Restore image using a regularized filter 


= deconvreg(I,PSF) 
deconvreg(I,PSF ,NOISEPOWER) 
deconvreg(I,PSF ,NOISEPOWER ,LRANGE ) 


= deconvreg(I,PSF ,NOISEPOWER ,LRANGE ,REGOP ) 
JdJ，LAGRA] = deconvreg(I,PSF，...) 


一 CC CC 
中 


J = deconvreg(I,PSF) restores image Ithat was degraded by convolution with 
a point-spread function PSF and possibly by additive noise. The algorithm is a 
congstrained optimum in a sense of least square erTor between the estimated 
and the true images under requirement of preserving image smoothness. 


J = deconvreg(I,PSF,NOISEPOWER), where NOISEPOWER is the addqitive noise 
power. The default value is 0. 


J = deconvreg(I,PSF,NOISEPOWER,LRANGE)， where LRANGE is a vector 
specifying range where the search for the optimal solution is performed. The 
algorithm finds an optimal Lagrange multiplier, LAGRA, within the LRANGE 
range. 玉 LRANGE is a scalar, the algorithm assumes that LAGRA is given and 
equal to LRANGE; the NP value is then ignored. The default range is between 
[le-9 and le9|]. 


J = deconvreg(I,PSF,NOISEPOWER,LRANGE ,REGOP), where REGOP is the 
regularization operator to constrain the deconvolution. The default 
regularization operator is the Laplacian operator, to retain the image 
smoothness. The REGOP array dimensions must not exceed the image 
dimensions, anynonsingleton dimensions must correspond to the nonsingleton 
dimensions of PSF. 


[J，LAGRA] = deconvreg(I,PSF,...) outputs the value ofthe Lagrange 
multiplier, LAGRA, in addition to the restored image J. 





Nofte The output image J could exhibit ringing introduced by the discrete 
Fourier transform used in the algorithm. To reduce the ringing, process the 
image with the edgetaper function prior to calling the deconvreg function; for 
example,I = edgetaper(I,PSF) . 
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Class Suppor 


Example 


See Also 
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I can be ofclass uint8, uint16, or double. Other inputs have to be of class 
double. J is of the same class as I. 


I = checkerboard(8) ; 

PSF = fspecial('gaussian' ,7,10) ; 

V= .01; 

BlurredNolisy = imnoise(imfilter(I,PSF)，gaussian' ,0,V) 
NOISEPOWER = V*prod(Size(I) ) ; 

[J_ LAGRA] = deconvreg(BlLurredNolisy,PSF,NOISEPOWER ) ; 


Subplot(221); imshow(BlLurredNoisy ) ; 

title('A= Blurred and Nolisy ) 

Subp1lot(222); imshow(J) ; 

tit1le('` [J LAGRA] = deconvreg(A,PSF,NP) ) ; 

Subplot(223); imshow(deconvreg(BlLlurredNoisy,PSF,[],LAGRA/10) ) ; 
title('deconvreg(A,PSF,[],0.1*LAGRA) '); 

Subp1lot(224); imshow(deconvreg(BlLurredNoisy,PSF,[],LAGRA*10) ) ; 
title( deconvreg(A,PSF,[],10*LAGRA) ) ; 


deconvb1lind, deconvlucy, deconvwnr, otf2psf, padarray, psf2otf 
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Purpose 


Synftax 


Descripfion 


Class Suppor 


Example 


Restore image using the Wiener filter 


世 


= deconvwnr(I,PSF ) 
deconvwnr (I,PSF ,NSR) 
= deconvwnr(I,PSF ,NCORR ,ICORR ) 


J = deconvwnr(I,PSF) restores image Ithat was degraded by convolution with 
a point-spread fanction, PSF, and possibly by additive noise. The algorithm is 
optimal in a sense ofleast mean Square erTror between the estimated and the 
true image, and uses the correlation matrixes of imnage and noise. In the 
absence ofnoise, the Weiner filter reduces to the ideal inverse 五 ]ter. 


J 


= deconvwnr(I,PSF,NSR), where NSR is the noise-to-signal power ratio. NSR 


could be a scalar or an arTray ofthe same Size as I. The default value is 0. 


J 


= deconvwnr(I,PSF,NCORR,ICORR), where NCORR and ICORR are the 


autocorrelation functions ofthe noise and the original image, respectively. 
NCORR and ICORR could be of any size or dimension not exceeding the original 
image. An N-dimensional NCORR or ICORR arTray corresponds to the 
autocorrelation within each dimension. A vector NCORR or ICORR represents an 
autocorrelation fanction in first dimension 这 PSF is a vector. IfPSF is an arTay， 
the 1-D autocorrelation fonction is extrapolated by symmetry to al 
nonsingleton dimensions of PSF. A scalar NCORR or ICORR represents the power 
of the noise or the image. 





Note The output image J could exhibit ringing introduced by the discrete 
Fourier transform used in the algorithm. To reduce the ringing, process the 
image with the edgetaper function prior to calling the deconvwnr function; for 
example,I = edgetaper(I,PSF) 





I can be ofclass uint8, uint16, or double. Other inputs have to be of class 
double. J is ofthe same class as I. 


工 = checkerboard(8) ; 

noise = 0.1x*randn(Size(I) ) ; 

PSF = fspecial( motion ,21,11) ; 
Blurred = imfilter(I,PSF，circular ' ) ; 
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BlurredNolisy = im2uint8(Blurred + noise) ; 


NSR = Sum(noise(:).^2)/Sum(I(:).^2);%5 noise-to-power ratio 


NP = abs(fftn(noise)).^2;%5 noise power 

NPOW = Sum(NP(:))/prod(Ssize(noise) ) ; 

NCORR = fftshift(real(ifftn(NP) ));s% noise autocorrelation 
function，centered 


IP= abs(fftn(I)).^2;% original image power 

IPOW = Sum(IP(:))/prod(size(I) ) ; 

ICORR = fftshift(real(ifftn(IP))); 先 Image autocorrelation 
function，centered 

ICORR1 = ICORR(:,ceil(Size(I,1)/2) ) ; 


NSR = NPOW/IPOW; 

Subp1lot(221) ;imshow(BLurredNoisy,[]); 

title('A= Blurred and Nolisy ) ; 

Subplot(222) ;imshow(deconvwnr(BLurredNoisy,PSF,NSR),[]); 

tit1le(' deconvwnr(A,PSF ,NSR) ) ; 

Subplot(223) ;imshow(deconvwnr(BLurredNoisy,PSF,NCORR,ICORR)，[]); 
title('dqeconvwnr(A,PSF,NCORR,ICORR) ' ) ; 

Subplot(224) ;imshow(deconvwnr(BLurredNoisy,PSF,NPOW,ICORR1)，[]); 
title('deconvwnr(A,PSF,NPOW,ICORR 1 _D) '); 


See Also deconvb1lind, deconvlucy, deconvreg, otf2psf, padarray, psf2otf 
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Purpose 


Syntax 


Descripfion 


Examples 


See Also 


Read metadata from a DICOM message 


info = dicominfo(filename) 
info = dicominfo(filename，dictionary ，D) 


info = dicominfo(filename) reads the metadata fom the compliant Digital 
Imaging and Communications in Medicine (DICOM) file specified in the string， 
filename. 


info = dicominfo(filename，dictionary'，D) uses the data dictionary file 


given in the string D to read the DICOM message. The file in D must be on the 
MATLAB search path. The default qictionary file is dicom-dict,txt. 


info = dicominfo(' CT-MONO2-16-ankle.dcm ') 


Info = 


Filename: [1x47 char] 
FileModDate: '`24-Dec-2000 19:54:47， 

FileSize: 525436 

Format: 'DICOM 
FormatVersion: 3 

Width: 512 
Height: 512 

BitDepth: 16 

ColorType: .grayScale， 


dicomread, dicomwrite 
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PurPpose 


Syntax 


Descripfion 


14-108 


Read a DICOM image 


X = dicomread(filename) 

X = dicomread(info) 

[X,map] = dicomread(...) 

[X,map,alpha]l = dicomread(...,) 
[X,map,alpha,overlays] = dicomread(...) 


X = dicomread(filename) reads the image data fom the compliant Digital 
Imaging and Communications in Medicine (DICOM) file, filename. For 
single-fframe grayscale images, X is an M-by-N array. For single-frame 
true-color images, X is an M-by-N-by-3 array. Multiframe images are always 
4-D arTays. 


X = dicomread(info) reads the image data 位 om the message referenced in 
the DICOM metadata structure info. The info Structure is produced by the 
dicominfo fanction. 


[X,map] = dicomread(...) returns the image X and the colormap MAP. If X is 
a grayscale or true-color image, MAP is empty. 


[X,map,alpha]l = dicomread(...) returnstheimage X,the colormap map, and 
an alpha channel matrix for X. The values ofalpha are 0 ifthe pixel is opaque; 
otherwise they are row indices into map. The RGB value in map should be 
Substituted for the value in X to use alpha. alpha has the same height and 
width as X and is 4-D for a multiframe image. 


[X,map,alpha,overlays] = dicomread(...) alsoreturns the image X, the 
colormap map, an alpha channel matrix for X, and any overlays from the 
DICOM file. Each overlay is a 1-bit black and white image with the same 
height and width as X. Imultiple overlays are present in the fle, overlays is 
a4-D multiframe image. Ino overlays are in the file, overlays is empty. 


The first input argument, either filename or info, can be followed by a set of 
parameter name/value pairs. 


[...] = dicomread(filename,param1，Vvalue1，param2，value2，...,) 
[...] = dicomread(info，param1，Vvalue1，param2，Vvalue2，...) 


dicomread 





Supported parameters names and values include the following. 





Frames' ，V dicomread reads only the 他 ames in the vector V 位 om 
the image. V must be an integer scalar a vector of 
integers, or the String 'al1'.The dqefault value is 
“al . 


'Dictionary ，D dicomread uses the data dictionary fle whose 
和 lename is in the string D. The default value is 
“dicom-dict.txt '. 


“Raw ，TF dicomread performs pixel-level transformations 
depending on whether TF is 1or 0. ITFis 1 (the 
default), dicomread reads the exact pixels from the 
image and no pixel-level transformationgs are 
performed. IfTF is 0, images are rescaled to use the 
f 包 11 dynamic range, and color images are 
automatically converted to the RGB colorspace. 
Note 1: Because the HSV colorspace is inadequately 
defined in the DICOM standard, dicomread does not 
automatically convert them to RGB. 

Note 2: dicomread never rescales or changes the 
color Spaces of images containing signed data. 

Note 3: Rescaling values and applying colorspace 
conversions does not change the metadata in any 
way Consequently metadata values that refer to 
pixel values (Such as window center/width or LUTS) 
may not be correct when pixels are scaled or 
converted. 





Examples Example 1 
Use dicomread toretrieve the data matrix, X, and colormap matrix, map,needed 
to create a montage. 


[X，map] = dicomread('US-PAL-8-10x-echo.dcm' ); 
montage(X，map) ; 
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Example 2 
Call dicomread with the information retrieved from the DICOM file using 
dicominfo. Display the image with imshow. 


info = dicominfo( CT-MONO2-16-ankle.dcm ' ); 
Y = dicomread(info) ; 
imshow(Y，[] ) ; 


See Also dicominfo, dicomwrite 
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Purpose 


Syntax 


Descripfion 


Write imnages as DICOM file 


dicomwrite(X，filename) 
dicomwrite(X，map，filename) 
dicomwrite(...，param1,value1,param2 ,value2，...) 
dicomwrite(...，meta_ struct,...) 

dicomwrite(...， info,...) 


Status = dicomwrite(...) 


dicomwrite(X,filename) writes the binary, grayscale, or truecolor image, X， 
to the file, filename, where filename is a string specifying the name of the 
Digital Imaging and Communications in Medicine (DICOMI) file to create. 


dicomwrite(X,map,filename) writes the indexed image, X, with colormap， 
map. 


dicomwrite(...;,param1,value1,param2,value2,...) specifies addqitional 
metadata to write to the DICOM file.The parameters (param1, param2, etc.) are 
either names of DICOM file attributes or options that affect how the file is 
written. Each attribute or option has a corresponding value (value1, value2， 
etc.). 


To find a list ofthe names ofDICOM attributes, see the data dictionary file， 
dicom-dict.txt, included with the Image Processing Toolbox. 


This table lists the options Supported by the dicomwrite fanction， 





Option Name 


Descripfion Values 





"Endian'， 


IVR 


Specifies the byte-ordering for the 'Litt1e' [Default] 


file. Big 

Specifies whether the two-letter 'Implicit' [Defaultl 

value representation (VR) code 'EXp1licit' 

should be written to the file Note: Iyou specify the 

('explicit') or inferred from the 'Endian' value 'Big' ,you can 

data dictionary ('imp1icit '). only specify the 'VR' value of 
"EXpJicit . 





14-111 


dicomwrife 











Opiion Name Descripfion Values 

'CompressionMode' Specifies the type of compression 'None'” [Defaujlt] 
to use when storing the image. 'JPEG 1ossy'， 

'RLE 

'TransferSyntax ADICOM UID specifying the ADICOM Transfer Syntaxthat 
DICOM Transfer Syntax. specifies the default values for 
Note: Iyou specify the 'Endian'，'VR'， and 
TransferSyntax ' option， 'CompressionMode ' options. 


dicomwrite ignores the other 
three options, fthey are specified. 
The TransferSyntax' option 
encodes the settings for the 
'Endian'，'VR' and 
'CompressionMode' options in a 
single value. 





dicomwrite(...,meta_ struct,...) specifies metadata in a structure， 
meta_struct. The structure's field names must be the names of DICOM file 
attributes or options. The fieldq's value is the value of that attribute or option. 


dicomwrite(...,info,...) specifies metadata in the metadata structure， 
info, which is produced by the dicominfo function. For more information 
about this structure, see dicominfo. 


status = dicomwrite(...) returngs astructure that lists three types of 
metadata that were passed to dicomwrite: 

e Metadata that does not affect how the DICOM file is written 

e Metadata that does not pertain to the type of imnage being written 

e Metadata that is not modifiable by a user 

This syntax can be useful when you specify an info structure that was created 


by dicominfotothe dicomwrite function. An info structure can contain many 
fieldqs. Ifno metadata was specified, dicomwrite returns an empty matrix ([]). 
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Example 


The structure returned by dicomwrite contains these three fieldqs. 





Field Descripfion 


"dicominfo _ fields'” Acell array containing the names of metadata 
passed to dicomwrite that does not affect hovw the 
和 le is written . 


'wrong_I0D， Acell array containing the names of attributes 
passed to dicomwrite that do not pertain to the 
type of image being written. (IOD=Information 
Object Definition) 


'not_modifiab1le， Acell array containing the names of valid 
metadata fields for the image that cannot be 
modified by the user. 





This example uses dicominfo to retrieve information about the contents ofthe 
sample DICOM file included with the Image Processing Toolbox. The example 
uses dicomread to read the data from the file and then writes the data into a 
new DICOM file, including the metadata from the original file. 


info = dicominfo('CcT-MONO2-16-ankle.dcm' ); 

Y = dicomread(info) ; 

Status = dicomwrite(Y，my_dicomfile.dcm' info) ; 
Status = 


dicominfo fields: {12x1 cel1} 
Wrong_IOD: {21x1 cel1} 
not_modifiable: {23x1 cel1} 


Status.dicominfo fields 
ans = 


'BitDepth' 
"上 ColorType- 
"FIlLeModDate， 
"FIleSize， 
“FIleStruct 
"FIlename， 
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"Format 
"FormatVersion'， 
Height 
'SelectedFrames-， 
'StartOfPixelData， 
'Width'， 


See Also dicomread, dicominfo 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 


Example 


Perform dilation on a binary image 





Nofte This function is obsolete and may be removed in future versions. Use 
imdilate instead. 





BW2 = dilate(BW1,SE) 
BW2 dilate(BW1,SE,aJ7g) 
BW2 = dilate(BW1,SE,...，n) 


BW2 = dilate(BW1,SE) performs dilation on the binary image BW1, using the 
binary structuring element SE. SE is a matrix containing only 1s and 0'8. 


BW2 = dilate(BW1,SE,a79) performs dilation using the specified algorithm. 
alg is a string that can have one ofthese values: 


e 'spatial' (default) - processes the image in the spatial domain. 


e 'frequency ' - processes the image in the frequency domain. 


Both algorithms produce the same result, but they make different trade-offs 
between speed and memory use. The frequency algorithm is faster for large 
images and structuring elements than the spatial algorithm, but uses much 
more memory， 


BW2 = dilate(BW1,SE,...,n) performs the dilation operation n times， 


The input image BW1 can be of class double or uint8. The output image BW2 is 
of class uint8. 


You should use the frequency algorithm only ifyou have a large amount of 
memory on your system. Ifyou use this algorithm with insufficient memory, 让 
may actually be s/ower than the spatial algorithm, due to virtual memory 
paging. Ifthe 位 equency algorithm slows down your System excessively, or 让 
you receive“out of memory”messages, use the spatial algorithm instead. 


BW1 = imread( text.tif ' ) ; 


SE = ones(6,2) | 
BW2 = dilate(BW1,SE) ; 
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See Also 


References 
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imshow(BW1 ) 
figure，imshow(BW2) 
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bwmorph,， imdilate, imerode 
[Gonzalez, Rafael C., and Richard 了 上 . Woods. DigSzta/! 1aagse Process1105. 
Addison-Wesley, 1992. p. 518. 


[2] Haralick, Robert M., and Linda G. Shapiro. Comzpxter ad Robpot Visio7， 
Volxme 了 Addison-Wesley, 1992. p. 158. 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Algorithm 


References 


See Also 


Convert an image, increasing apparent color resolution by dithering 


X = dither(RGB,map) 
BW = dither(I) 


X = dither(RGB,map) creates an indexed image approximation ofthe RGB 
image in the array RGB by dithering the colors in colormap map. map can mnot 
have more than 65,536 colors. 


X = dither(RGB,map,Qm,Qe) creates an indexed image fom RGB, specifying the 
parameters Qm and Qe. Qm specifies the number ofquantization bits to use along 
each color axis for the inverse color map, and Qe specifies the number of 
quantization bits to use for the color space error calculations. IfQe < Qm， 
dithering cannot be performed and an undithered indexed image is returned in 
X. Ifyou omit these parameters, dither uses the default values Qm = 5, Qe = 8. 


BW = dither(I) converts the intensity image in the matrix I to the binary 
(black and white) image BW by dithering. 


The input image, RGB or I, can be of class uint8, uint16, or double. All other 
input arguments must be of class double. The output indexed image, X, is of 
class uint8 计 itis an indexed image with 256 or fewer colors; otherwise its clasgs 
is uint16. The output binary image, BW, is of class 1ogical. 


dither increases the apparent color resolution of an image by applying 
Floyd-Steinberg”s error diffusion qither algorithm. 


[Floyd, R. W. and .Steinberg.“An Adaptive Algorithm for Spatial Gray 
Scale,”71jztermzatiomal Sy72DosIU10 Dig5est of TecHAmaical Papers. Society for 
Information Displays, 1975. p. 36. 


[2] Lim, Jae S. 7Tzo-Dimze7siozal Sis7al a12Q 112age Processi1s. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 469-476. 


rgb2ind 
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PurPpose Convert data to double precision 


double is a MATLAB built-in function. To get help for this foanction, select 
MATLAB Help from the Help menu and view the online function reference 


page. 
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Purpose 


Syntax 


Descripfion 


Find edges in an intensity image 


BW = edge(I，Ssobel ) 

BW = edge(I，sobel ,thresh) 

BW = edge(I，sobel ,thresh,direction) 
[BW,thresh] = edge(I，Sobel ，...) 


BW = edge(I，prewitt ) 

BW = edge(I，prewitt ,thresh ) 

BW = edge(I，prewitt ' ,thresh,direction) 
[BW,thresh] = edge(I，prewitt ，...) 


BW = edge(I，roberts ') 
BW = edge(I，roberts ,thresh ) 
[BW,thresh] = edge(I，roberts ，...) 


BW = edge(I，1og ) 

BW = edge(I，1og ' ,thresh ) 

BW = edge(I，1og ' ,thresh,Ssigmal) 
[BW,threshold] = edge(I，10g ，...) 


BW = edge(I，zerocross ,thresh,h) 
[BW,thresh] = edge(I，zerocross ，.,.) 


BW = edge(I，canny ) 

BW = edge(I，canny ,thresh) 

BW = edge(I，canny ,thresh,sigmal) 
[BW,threshold] = edge(I，canny ，..,) 


edge takes an intensity image I as its input, and returns a binary image BW of 
the same Size as I, with 1 where the function finds edges in I and 0'S 
elsewhere. 


edge Supports Six different edge-finding methods: 


e The Sobel method finds edges using the Sobel approximation to the 
derivative. It returns edges at those points where the gradient of I is 
maximumm， 
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e The Prewitt method finds edges using the Prewitt approximation to the 
derivative. It returns edges at those points where the gradient of I is 
maximum. 

e The Roberts method finds edges using the Roberts approximation to the 
derivative. It returns edges at those points where the gradient of I is 
maximum. 

se The Laplacian of Gaussian method finds edges by looking for zero crossings 
after filtering I with a Laplacian of Gaussian filter. 

e The zero-cross method finds edges by looking for zero crossings after filtering 
I with a filter you specify. 

e The Canny method finds edges bylooking for local maxima ofthe gradient of 
I. The gradient is calculated using the derivative of a Gaussian fjter. The 
method uses two thresholdqs, to detect strong and weak edges, and includes 
the weak edges in the output only ifthey are connected to strong edges. This 
method is therefore less likely than the others to be “fooledq”by noise, and 
Imore likely to detect true weak edges, 


The parameters you can Supply differ depending on the method you specify. I 工 
you do not specify a method, edge uses the Sobel method. 


Sobel Method 

BW = edge(I，sobel' ) specifies the Sobel method. 

BW = edge(I,'sobel' ,thresh) specifies the sensitivity threshold for the Sobel 
method. edge ignores all edges that are not stronger than thresh. Ifyou donot 


specify thresh, or 让 thresh is empty ([]), edge chooses the value 
automatically. 


BW = edge(I，'sobel' ,thresh,direction) specifies dqirection of detection for 
the Sobel method. direction is a string specifying whether to look for 
'horizontal' or 'vertical' edges, or 'both' (the default). 


[BW,thresh] = edge(I，'sobel1',...) returns the threshold value. 
Prewitt Method 
BW = edge(I，prewitt ' ) specifies the Prewitt method. 


BW = edge(I，prewitt' ,thresh) specifies the sensitivity threshold for the 
Prewitt method. edge ignores all edges that are not stronger than thresh. 工 


edge 





you do not specify thresh, or 让 thresh is empty ([]), edge chooses the value 
automatically. 


BW = edge(I，prewitt' ,thresh,direction) specifies direction of detection 
for the Prewitt method. direction is a string specifying whether to look for 
'horizontal' or 'vertical' edges, or 'both' (the default). 


[BW,thresh] = edge(I，prewitt',...) returns the threshold value. 


Roberts Method 

BW = edge(I,method) specifies the Roberts method. 

BW = edge(I,method,thresh) specifies the sengsitivity threshold for the 
Roberts method. edge ignores all edges that are not stronger than thresh. 下 


you do not specify thresh, or 让 thresh is empty ([]), edge chooses the value 
automatically. 


[BW,thresh] = edge(I,method, ...) returns the threshold value. 


Laplacian of Gaussian Method 

BW = edge(I，'1og ') specifies the Laplacian of Gaussian method. 

BW = edge(I，1og',thresh) specifies the sensitivity threshold for the 
Laplacian of Gaussian method. edge ignores all edges that are not Stronger 


than thresh. Ifyou do not specify thresh, or 让 thresh is empty ([]), edge 
chooses the value automatically. 


BW = edge(I，'1og',thresh,sigma) specifies the Laplacian of Gaussian 
method, using Sigma as the standard deviation ofthe LoG filter. The default 
sigmais 2; the size ofthe flter is n-by-n, wheren= ceil(sigmax3)*2+1. 


[BW,thresh] = edge(I，'1og'，,...) returns the threshold value. 


Zero-cross Method 


BW = edge(I,，'zerocross' ,thresh,h) specifies the zero-cross method, using 
the filter h. thresh is the sensitivity thresholdq; ifthe argument is empty ([ ])， 
edge chooses the sengsitivity threshold automatically. 


[BW,thresh] = edge(I，'zerocross',...) returns the threshold value. 
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Class Suppor 


Remarks 


Example 
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Canny Method 
BW = edge(I，canny ' ) specifies the Canny method. 


BW = edge(I，canny' ,thresh) specifies sensitivity thresholdqs for the Canny 
method. thresh is a two-element vector in which the first element is the low 
threshold, and the second element is the high threshold. Ifyou specify a scalar 
for thresh, this value is used for thehigh threshold and 0.4*thresh is used for 
the low threshold. Ifyou do not specify thresh, or 这 thresh is empty ([]), edge 
chooses low and high values automatically. 


BW = edge(I，canny' ,thresh,sigma) specifies the Canny method, using 
sigma as the standard deviation ofthe Gaussian lter. The qdqefault sigma is 1; 
the size ofthe filter is chosen automatically, based on sigma. 


[BW,thresh] = edge(I，canny ',...) returns the threshold values as a 
two-element vector. 


I can be ofclass uint8, uint16, or doub1le. BW is of class 1ogical. 


For the '1og' and 'zerocross' methods, 让 you specify a threshold of 0, the 
output image has closed contours, because it includes all of the zero crossings 
in the input image, 


Find the edges ofthe rice.tif imnage using the Prewitt and Canny methods. 


I = imread(' Price.tif ' ); 
BW1 = edge(I，prewitt ' ) ; 
BW2 = edge(I，canny ) ; 
imshow(BW1 ) ; 
figure，imshow(BW2) 


edge 





See Also 


References 





fspecial 


[Canny, John.“A Computational Approach to Edge Detection,”7 五 严 玉 
77ra7sactio7s o7 Patter 4A712alysis azQ MacPz7e 17atelLzcezce, 1986.Vol. PAMI-8， 
No. 6, pp. 679-698. 


[2] Lim, Jae S. Tzo-Dimzezsiozal Sismal aa 1711agse Process1115. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 478-488. 


[3] Parker, James R. ALgorztpms jor 11aase Processi1ngS ad Co172Dzter Visio7. 
New York: John Wiley & Sons, Inc., 1997. pp. 23-29. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 
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Taper the discontinuities along the image edges 


J = edgetaper(I,PSF ) 


J = edgetaper(I,PSF) blurs the edges ofthe input image, I, using the point 
spread function, PSF. The output image, J, is the weighted sum ofthe original 
image, TI, and its blurred version. The weighting array, determined by the 
autocorrelation fanction of PSF, makes J equal to I in its central region, and 
equal to the blurred version of I near the edges. 


Theedgetaper function reduces theringing effect in image deblurring methods 
that use the discrete 了 Fourier transform, such as deconvwnr, deconvreg, and 
deconv1Lucy. 





Nofte The size ofthe PSF cannot exceed halfofthe image size in any 
dimension . 





I and PSF can be of class uint8, uint16, or double. J is of the same class as I. 


I = imread(' cameraman.tif ' ) ; 

PSF = fspecial('gaussian' ,60,10) ; 

JdJ = edgetaper(I,PSF) ; 
Subplot(1,2,1);imshow(I,[]);title( original image ) 
Subplot(1,2,2);imshow(J,[]);title( edges tapered ) |; 


deconvJlucy, deconvreg, deconvwnr, otf2psf, padarray, psf2otf 


erode 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 


Example 


Perform erosion on a binary image 





Nofte This function is obsolete and may be removed in future versions. Use 
imerode instead. 





BW2 = erode(BW1,SE) 
BW2 = erode(BW1,SE,aJy9) 
BW2 = erode(BW1,SE,...，n) 


BW2 = erode(BW1,SE) performs erosion on the binary image BW1, using the 
binary structuring element SE. SE is a matrix containing only 1s and 0'8. 


BW2 = erode(BW1,SE,a719) performs erosion using the specified algorithm. a79 
is a string that can have one ofthese values: 


e 'spatial' (default) - processes the image in the spatial domain 


e 'frequency ' - processes the image in the frequency domain 


Both algorithms produce the same result, but they make different tradeoffs 
between speed and memory use. The frequency algorithm is faster for large 
images and structuring elements than the spatial algorithm, but uses much 
more memory， 


BW2 = erode(BW1,SE,...,n) performs the erosion operation n times， 


The input image BW1 can be of class double or uint8. The output image BW2 is 
of class uint8. 


You should use the frequency algorithm only ifyou have a large amount of 
memory on your system. Ifyou use this algorithm with insufficient memory, 让 
may actually be s/ower than the spatial algorithm, due to virtual memory 
paging. Ifthe 位 equency algorithm slows down your System excessively, or 让 
you receive“out of memory”messages, use the spatial algorithm instead. 


BW1 = imread( text.tif ' ) ; 


SE = ones(3,1) 
BW2 = erode(BW1,SE) ; 
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imshow(BW1 ) 
figure，imshow(BW2) 


Crfross-Cotrelation Used CS Is 
ToLocate 各 民 nhowt 
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See Also bwmorph, imdilate, imerode 


References [ 熙 Gonzalez, Rafael C., and Richard 卫 . Woods._ DigEzta/! 1aagse Processi105. 
Addison-Wesley, 1992. p. 518. 


[2] Haralick, Robert M., and Linda G. Shapiro. Comzpzter aq Robpot Visio7， 
Volxme 工 Addison-Wesley, 1992. p. 158. 
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Purpose Compute two-dqimensional fast Fourier transform 


fft2 is a function in MATLAB. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference page. 
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PurPpose Compute N-dqimensional fast Fourier transform 


fftn is a function in MATLAB. To get help for this fanction, select MATLAB 
Help 人 om the Help menu and view the online function reference page. 
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fftshift 





Purpose Shift zero-frequency component offast Fourier transform to center of spectrum 


fftshift is a function in MATLAB. To get help for this function, select 
MATLAB Help from the Help menu and view the online fanction reference 


page. 
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PurPpose Perform two-dqimensional linear filtering 


filter2 is a function in MATLAB. To get help for this function, select 
MATLAB Help from the Help menu and view the online function reference 


page. 
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findbounds 





Purpose 
Syntax 


Descripfion 


Notes 


Example 


See Also 


Find output bounds for spatial transformation 
outbounds = findbounds (TFORM ,Inbounds ) 


outbounds = findbounds(TFORM,inbounds) estimates the output bounds 
corresponding to a given spatial transformation and a set of input bounds. 
TFORM is a spatial transformation Structure as returned by maketfornm. 
inbounds is 2-by-NUM_DIMS matrix.The firstrow of inbounds specifies the lower 
bounds for each dimension, and the second row specifies the upper bounds. 
NUM_DIMS has to be consistent with the ndims_infield ofTFORM. 


outbounds has the same form as inbounds. It is an estimate ofthe smallest 
rectangular region completely containing the transformed rectangle 
represented by the input bounds. Since outbounds is only an estimate, it may 
not completely contain the transformed input rectangle. 


imtransform uses findbounds to compute the 'OutputBounds' parameter 让 
the user does not provide 二 . 


ITFORM contains a forward transformation (a nonempty forward fcn field)， 
then findbounds works by transforming the vertices ofthe input bounds 
rectangle and then taking minimum and maximum values of the result. 


IfTFORM qoes not contain a forward transformation, then findbounds estimates 
the output bounds using the Nelder-Mead optimization function fminsearch. 
HIthe optimization procedure fails, findbounds issues a warning and returns 
outbounds=inbounds. 


inbounds = [0 0; 1 1] 
tform = maketform( affine' ,[200; .530;001]) 
outbounds = findbounds (tform，inbounds ) 


cp2tform, imtransform, maketform, tformarray, tformfwd, tforminv 
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PurPpose 
Syntax 


Descripfion 


Example 


See Also 
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Flip the input and output roles of a TFORM Structure 
TFLIP = flLiptform(T) 


TFLIP = fliptform(T) creates anew spatial transformation structure, aTFORM 
struct, by flipping the roles ofthe inputs and outputs in an existing TFORM 
Struct. 


T = maketformn(' affine' ，[.500;j .5 20;001]); 
T2 = fliptform(T) 
The following are equivalent: 
Xx = tformfwd([-3 7]),T) 
Xx = tforminv([-3 7],T2) 


maketform, tformfwd, tformIznv 


freqspace 





Purpose Determine frequency spacing for two-dimensional frequency response 


freqspace is a function in MATLAB. To get help for this function, select 
MATLAB Help from the Help menu and view the online fanction reference 


page. 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 
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Compute two-dimensional frequency response 


[H,f1,f2] = fredqz2(h,n1,n2) 
[H,f1,f2] = fredqz2(h,[n2 ni1]) 
[H,f1,f2] = fredqz2(h,f1,f2) 
[H,f1,f2] = fredqz2(h) 


[...] = freqz2(h,...,，[dx dyl]) 
[...] = freqz2(h,.. .dx) 
freqz2(...) 


[H,f1,f2] = freqz2(h,n1,n2) returns H, the n2-by-n1 位 equency response of 
h, and the frequency vectors f1 (of length n1) and f2 (of length n2). h is a 
two-dimensional FIR flter, in the form of a computational molecule. f1 and f2 
are returned as normalized ffequencies in the range -1.0 to 1.0, where 1.0 
corresponds to halfthe sampling frequency, or Tradians. 


[H,f1,f2] = freqz2(h,[n2 n1]) returns the same result returned by 
[H,f1,f2] = freqz2(h,n1,n2). 


[H,f1,f2] = fredqz2(h) uses [n2 n1] = [64 641]. 


[H,f1,f2] = freqz2(h,f1,f2) returns the 位 equency response for the FIR 
filter h at 他 equencyvalues in f1 and f2. These frequency values mustbe in the 
range -1.0 to 1.0, where 1.0 corresponds to halfthe sampling 他 equency, or 元 
radians， 


[...] = freqz2(h,...,[dx dy]) uses [dx dy] to override the intersample 
spacing in h. dx determines the spacing for thex-dimension and dy determines 
the spacing for the y-dimension. The default spacing is 0.5, which corresponds 
to a sampling frequency of 2.0. 


[...] = freqz2(h,...,dx) uses dx to determine the intersample spacing in 
both dimensions. 


With no output arguments, freqz2(...) produces amesh plot ofthe 


two-dimensional magnitude 位 equency response. 


The input matrix h can be of class double or of any integer class. All other 
inputs to fredqz2 must be of class double. All outputs are of class double. 


freqz2 





Use the window method to create a 16-by-16 filter, then View its frequency 

















Example 
response Usling fredqz2. 
Hd = zeros(16,16) ; 
Hd(5:12;5:12) = 1; 
Hd(7:10,7:10) = 0 
h = fwind1(Hd,bartlett(16) ) ; 
colormap (jet(64) ) 
freqz2(h,[32 32]); axis ([-11 -1101]) 
1 
08 窜 AS: 
SS f V WK 
。 0.6 AT TAN 八 | j 
1 
AU 人 ADY 
呈 04 | W 
Frequency 二 Frequency 
See Also freqz in the Sal Processi7g Tool1box Users Guzae 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 
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Design two-dimensional FIR filter using frequency sampling 


h = fsamp2(Hd) 
h fsamp2(f1,f2,Hd,[mn]) 


fsamp2 designs two-dimensional FIR filters based on a desired 
two-dimensional frequency response sampled at points on the Cartesian plane. 


h = fsamp2(Hd) designgs a two-dqimensional FIR flter with frequency response 
Hd, and returns the flter coefcients in matrix h. (fsamp2 returns h as 3 
computational molecule, which is the appropriate form to use with filter2.) 
The filter h has a 他 equency response that passes through points in Hd. If Hd is 
m-by-n, then h is also m-by-n. 


Hd is a matrix containing the desired frequency response Sampled at equally 
spaced points between -1.0 and 1.0 along thexand y frequency axes, where 1.0 
corresponds to halfthe sampling frequency, or Tradians. 


克 7 = 书 v (oO1, 0 
at 12) df 和 | os = Tj 

For accurate results, use frequency points returned by freqspace to create Hd. 

(See the entry for fredqspace for more information.) 


h = fsamp2(f1,f2,Hd,[m n]) produces an m-by-n FIR filter by matching the 

和 lter response at the points in the vectors f1 and f2. The 人 frequency vectors f1 
and f2 are in normalized frequency, where 1.0 corresponds tohalfthe sampling 
位 equency, orTradians. Theresulting filter fits the desired response as closely 
as possible in the least squares sense. For best results, there must be at least 
mxn desired frequency points. fsamp2 issues a warning 计 you specify fewer than 
mxn points. 


The input matrix Hd can be of class double or of any integer class. All other 
inputs to fsamp2 must be of class double. All outputs are of class doub1le. 


Use fsamp2 to design an approximately symmetric two-dimensional bandpass 
filter with passband between 0.1 and 0.5 (normalized frequency, where 1.0 
corresponds to halfthe sampling frequency, or Tradians): 


1 _ Create a matrix Hd that contains the desired bandpass response. Use 
freqspace to create the 位 equency range vectors f1 and f2. 


fsampP2 





freqspace(21，meshgrid ) ; 


[f1,f2] = 
ones(21 ) 


Hd 


.2 + f2.^2) 


Hd((r<0.1)|(r>0.5)) = 0) 


FF = Sdqrt(fl 
colormap(jet(64) ) 
mesh(f1,f2,Hd) 
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2 Design the filter that passes through this response. 


freqz2(h) 
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Algorithm 


See Also 


Reference 
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Frequency Frequency 


fsamp2 computes the filter h by taking the inverse discrete Fourier transform 
ofthe desired frequency response. Ifthe desired frequency response is real and 
symmetric (zero phasej, the resulting filter is also zero phase. 


conv2, filter2, freqspace, ftrans2, fwind1, fwind2 


[Lim, Jae S. 7Tzo-DimazemnsiozzalL Sis7al aa 11rase Processi115. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 213-217. 


fspecial 





Purpose 


Syntax 


Descripfion 


Create 2-D special 有 lters 


h = fspeclial(type) 
h = fspecial(type,parameters ) 


h = fspecial(type) creates atwo-dimensional filter, h, ofthe specified type. 
fspecialreturns h as a correlation kernel, which is the appropriate form to use 
with imfilter. type is a string having one ofthese values: 


e 'gaussian' for a Gaussian lowpass filter 


'Sobel' for a Sobel horizontal edge-emphasizing filter 


'prewitt' for a Prewitt horizontal edge-emphasizing filter 


' Laplacian' for afilter approximating the two-dimensional Laplacian 
Operator 


'1og' for aLaplacian of Gaussian filter 


'average' for an averaging filter 


'unsharp' for an unsharp contrast enhancement 和 lter 


h = fspecial(type,parameters) accepts afilter type plus additional 
modifying parameters particular to the type of filter chosen. Ifyou omit these 
arguments, fspecial uses default values for the parameters, 


The following list shows the syntax for each filter type. Where applicable， 
additional parameters are also shown. 


eh=fspecial('average',hsize) returns an averaging filter, h, of size 
hsize. The argument hsize can be a vector Specifying the number ofTrowsgs 
and columns in h, or it can be a scalar, in which case h is a square matrix. 
The default value for hsizeis [3 31]. 


eh=fspecial('disk',radius) returns a circular averaging filter (pillbox) 
within the square matrix of side 2*radius+1. The default radius is 5. 


eh=Tfspecial('gaussian',hsize,Ssigma) returns arotationally symmetric 
Gaussian lowpass filter of size hsize with standard deviation sigma 
(positive). hsize can be a vector specifying the number ofrows and columns 
in h, or it can be a scalar, in which case h is a square matrix. The default 
value for hsizeis [3 3]; the default value for sigma is 0.5. 

eh=fspecial('1Iaplacian',alpha) returns a 3-by-3 filter approximating 
the shape ofthe two-dimensional Laplacian operator. The parameter alpha 
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Class Suppor 


Example 
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h 


controls the shape ofthe Laplacian and must be in the range 0.0 to 1.0. The 
default value for alpha is 0.2. 


h = fspecial('1og' ,hsize,sigma) returns a rotationally symmetric 
Laplacian of Gaussian flter of size hsize with standard deviation sigma 
(positive). hsize can be a vector specifying the number ofrows and columns 
in h,oritcanbeascalar,in which casehis asquare matrix. The defaultvalue 
for hsizelis [5 5] and 0.5 for sigma. 


h = fspecial('motion' ,len,theta) returns a flter to approximate, once 
convolved with an image, the linear motion of a camera by len pixels, with 
an angle of theta degrees in a counter-clockwise direction. The filter 
becomes a vector for horizontal and vertical motions. The default lenis 9,the 
default theta is 0, which corresponds to a horizontal motion of 9 pixels. 


h = fspecial('prewitt') returns a 3-by-3 filter, h, (Shown below) that 
emphasizes horizontal edges by approximating a vertical gradient. Iyou 
need to eamphasize vertical edges, transpose the filter, h '. 


[ 江 计 革 
0 0 0 
-1-1-1] 
To find vertical edges, or for xderivatives, use h '. 


h = fspecial('sobel') returns a 3-by-3 filter, h, (Shown below) that 
emphasizes horizontal edges using the smoothing effect by approximating a 
vertical gradient. Ifyou need to emphasize vertical edges, transpose the 

丰 lter, h ' . 


[121 

0 0 0 

-1-2-1|] 
h = fspecial('unsharp' ,alpha) returns a 3-by-3 unsharp contrast 
enhancement filter. fspecial creates the unsharp filter 位 om the negative of 
the Laplacian filter with parameter alpha. alpha controls the shape of the 
Laplacian and must be in therange 0.0to 1.0. The default value for alpha is 
0.2. 


is of class double. 


I = imread(' Saturn.tif' ) ; 
Subplot(2,2,1);imshow(I) ;title(' Original Image ) ; 


fspecial 





H = fspecial( ' motion' ,50,45) ; 

MotionBlur = imfilter(I,H) ; 

Subplot(2,2,2) ;imshow(MotionBlur) ;title( Motion Blurred Image ' ) ; 
H = fspecial( disk ,10) ; 

blurred = imfilter(I,H) ; 

Subplot(2,2,3) ;imshow(blurred) ;ititle(' Blurred Image ') ; 

H = fspecial( unsharp ' ) ; 

Sharpened = imfilter(I,H) ; 

Subplot(2,2,4) ;imshow(Ssharpened) ;title( Sharpened Image ) ; 





0riginal Image 


多 


Mofion Blurred Image 





Blurred Image Sharpened Image 


Algorithms fspecial creates Gaussian filters Using 
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(+72)A(2G2) 
Ps(21, ma) = 6 和 


忆 s (21， 7p) 
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见 (71,722) = 


fspecial creates Laplacian filters using 


兄 2 
9X ” 097y 
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fspecial creates Laplacian of Gaussian (LoG) flters using 


(+712)A(2G2) 
Ps(D1, ma) = e 2 


2 2 2 
(1 +1 -2G )]e(P1, ma2) 


2ra yy js 


11 12 


见 (71,722) = 


fspecial creates averaging filters using 
ones(n(1)，n(2))/Cn(1)*n(2)) 
fspecial creates unsharp filters using 
1 -0 0Q-1 =-Q 
(+TJ|%- 1 Q+5 0X=-1I 


-0 Q-1 -=-Q 


See Also conv2, edge, filter2, fsamp2, fwind1, fwind2,， imf1Ilter 
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del2 in the MATLAB Function Reference 
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PurPpose Design two-dimensional FIR flter using frequency transformation 


Syntax h = ftrans2(b,t) 
h = ftrans2(b) 


Description h = ftrans2(b,t) produces thetwo-dimensional FIR filter h that correspondsgs 
to the one-dimensional FIR filter b using the transform t. (ftrans2 returns h 
as a computational molecule, which is the appropriate form to use with 
filter2.) b must be a one-dimensional, oddq-length (Type D FIR filter such 
as can be returned by firl, fir2, or remez in the Signal Processing Toolbox. 
The transform matrix t contains coefficients that define the 位 equency 
transformation to use. Ift is m-by-n and b has length Q, then h is Size 
((m-1)*(Q-1)/2+1)-by-((n-1)*(Q-1)/2+1). 


h = ftrans2(b) uses the McClellan transform matrix t. 
t= [121;2-42;j121]/8; 
Remarks The transformation below defines the ffequency response of the 


two-dimensional filter returned by ftrans2， 


鼠 (o0l, Oo) = DB(o)| 


cosSO = 了 (Qi, os) 
where B(o) is the Fourier transform of the one-dimensional 和 lter b， 


和 N 
B(o) = 》 D(z)e 7 
7 = 一 NV 


and 7{(olj,o) is the Fourier transform ofthe transformation matrix 七 . 


7T(ojl, oo) = tplmaje ie 


12 了 1 


The returned filter h is the inverse Fourier transform of 五 (ol,o2). 


开 开 
丸 (71, 12) = 一 | 刀 (o1， oaje re ”doldoos 
(2 元 ) “ -一 
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Example 


Use ftrans2 to design an approximately circularly symmetric two-dimensional 
bandpass filter with passband between 0.1 and 0.6 (normalized 人 ffequency， 
where 1.0 corresponds to halfthe sampling frequency, or T radians): 


1 Since ftrans2 transforms a one-dimensional FIR filter to create a 
two-dimensional filter, first design a one-dimensional FIR bandpass 丰 ]ter 
using the Signal Processing Toolbox function remez. 


colormap (jet(64) ) 

b = remez(10,[0 0.05 0.15 0.55 0.65 1],[001100]); 
[H,w] = freqz(b,1,128，whole ) 
plot(w/pi-1,fftshift(abs(H) )) 





0.6 上 | 


| 











2 Use ftrans2 with the default McClellan transformation to create the 
desired approximately circularly symmetric 和 lter. 


h = ftrans2(b) ; 
freqz2(h) 
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Reference 


14-146 

















12 人 
/ 人 SN 
ONNNNNNN 
1 上 和 0 2 全 NNR N 
电 08 0 0 SN 
呈 
总 0.6 
04 
02 














| 
人 
外 册 济 区 


， SN 
















0.5 


Frequency 


Frequency 


conv2, filter2, fsamp2, fwind1, fwind2 


[Lim, Jae 9. 7Tzo-DimazemsiozzalL Sis7al aa 1711rase Processi11S5. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 218-237. 
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Purpose 


Synftax 


Descripfion 


Class Suppor 


Design two-dimensional FIR filter using one-dimensional window method 


h = fwind1(Hd,win) 
h = fwind1(Hd,win1 ,win2) 
h = fwind1(f1,f2,Hd,...) 


fwind1 designs two-dimensional FIR flters using the windovw method. fwind1l 
uses a one-dimensional window specification to design a two-dimensional FIR 
filter based on the desired 位 equency response Hd. fwind1 works with 
one-dimensional windows only; use fwind2 to work with two-dqimensional 
windows， 


h = fwind1(Hd,win) designs a two-dimensional FIR flter h with frequency 
response Hd. (fwind1 returns h as a computational molecule, which is the 
appropriate form to use with filter2.) fwind1 uses the one-dimensional 
window win to form an approximately circularly symmetric two-dimensional 
window using Huang's method. You can specify win using windows from the 
Signal Processing Toolbox, such as boxcar, hamming, hanning, bart1lLett， 
blackman, kaiser, or chebwin. If length(win) is n, then h is n-by-n. 


Hd is a matrix containing the desired frequency response sampled at equally 
spaced points between -1.0 and 1.0 (in normalized frequency, where 1.0 
corresponds to halfthe sampling frequency, or fradians) along thexandy 
位 equency axes. For accurate results, use frequency points returned by 
freqspace to create Hd. (See the entry for freqspace for more information.) 


h = fwind1(Hd,win1,win2) uses the two one-dqimensional windows win1 and 
win2 to create a separable two-dimensional window. If length(win1) is n and 
Length(win2) is m, then h is m-by-n. 


h = fwind1(f1,f2,Hd,...) letsyouspecify the desired 他 equency response Hd 
at arbitrary frequencies (f1 and f2) along thexand y axes. The 他 equency 
vectors f1 and f2 should be in the range -1.0 to 1.0, where 1.0 corresponds to 
halfthe sampling frequency, orTradians. The length ofthe window(s) controls 
the size ofthe resulting filter, as above. 


The input matrix Hd can be of class double or of any integer class. All other 
inputs to fwind1 must be of class doub1le. All outputs are of class doub1e. 
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Example Use fwind1 to design an approximately circularly symmetric two-dimensional 
bandpass filter with passband between 0.1 and 0.5 (normalized frequency， 
where 1.0 corresponds to halfthe sampling frequency, or fradians): 


1 Create amatrix Hd that contains the desired bandpass response. Use 
freqspace to create the 他 equency range vectors f1 and f2. 


[f1,f2] = freqspace(21，meshgrid ) ; 
Hd = ones(21) ; 

= Sdqrt(f1.^2 + f2.^2) 
Hd((r<0.1)|(r>0.5)) = 0) 

colormap (jet(64) ) 

mesh(f1,f2,Hd) 





















































2 Design the filter using a one-dimensional Hamming window. 


h = fwind1(Hd,hamming(21) ) ; 
freqz2(h) 
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Algorithm 








Frequency 


Frequency 


fwind1 takes a one-dimensional window specification and forms an 
approximately circularly symmetric two-dimensional window using Huang's 
method， 


岂 (21, 有 2) = RU _ 


是 - 2 
11 十 72 


Where w(b is the one-dimensional window and w(mnlza2) is the resulting 
two-dimensional window， 


Given two windows, fwind1 forms a separable two-dimensional window， 
mW(21,72) = mW1(0021)Wo(722) 


fwind1 calls fwind2 with Hd and the two-dimensional window. fwind2 
computes h using an inverse Fourier transform and multiplication by the 
two-dimensional window， 


工 1721 Ja72 
ja(ilna) = 一 了 | | Botrooje ee ”doldaos 
(2 克 ) “ -一 


尹 (721, 12) = 灰 z(21, 2)w(21,7p) 
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See Also conv2, fiIilter2, fSsamp2, freqspace, ftrans2, fwind2 


Reference [Lim, Jae S. 7Tzo-DimazemnsiozalL Sis7al aa 711rase Processi1S5. Englewood 
Cliffs, NJ: Prentice Hall, 1990. 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Design two-dimensional FIR filter using two-dqimensional window method 


h = fwind2(Hd,win) 
h = fwind2(f1,f2,Hd,win) 


Use fwind2 to design two-dimensional FIR filters using the window method. 
fwind2 uses a two-dimensional window specification to design a 
two-dimensional FIR filter based on the desired frequency response Hd. fwind2 
works with two-dqimensional windows; use fwind1 to work with 
one-dimensional windows， 


h = fwind2(Hd,win) produces the two-dimensional FIR filter h using an 
inverse Fourier transform of the desired frequency response Hd and 
multiplication by the window win. Hd is a matrix containing the desired 

位 equency response at equally spaced points in the Cartesian plane. fwind2 
returns h as a computational molecule, which is the appropriate form to use 
with filter2. h is the same Size as win. 


For accurate results, use frequency points returned by freqspace to create Hd. 
(See the entry for freqspace for more information. 


h = fwind2(f1,f2,Hd,win) lets you specify the desired 他 equency response Hd 
at arbitrary frequencies (f1 and f2) along thexand y axes. The 人 ffequency 
vectors f1 and f2 should be in the range -1.0 to 1.0, where 1.0 corresponds to 
halfthe sampling 位 equency, or Tradians. h is the same Size as win. 


The input matrix Hd can be of class double or of any integer class. All other 
inputs to fwind2 must be of class doub1le. All outputs are of class doub1e. 


Use fwind2 to design an approximately circularly symmetric two-dimensional 
bandpass filter with passband between 0.1 and 0.5 (normalized 人 frequency， 
where 1.0 corresponds to halfthe sampling frequency, or T radiangs): 


1 _ Create a matrix Hd that contains the desired bandpass response. Use 
freqspace to create the 位 equency range vectors f1 and f2. 


[f1,f2] = freqspace(21，meshgrid  ) ; 
Hd = ones(21) 

= Sqrt(f1.^2 + f2.^2); 
Hd((r<0.1)|(r>0.5)) = 0 
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colormap(jet(64) ) 
mesh(f1,f2,Hd) 







































































2 Create atwo-dimensional Gaussian window using fspecial. 


fspecial( 'gausSsian ,21,2) ; 


Win 


Make the maximum window value be 1. 


56 


mesh(win) 
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3 Design the filter using the windovw 位 om step 2. 


freqz2(h) 
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Frequency 


Frequency 


Algorithm fwind2 computes h using an inverse Fourier transform and multiplication by 
the two-dimensional window win. 


1 MT Joi21 Jo27 
ja ma) = 一 了 | | Bootrooje ee ”dolidaos 
(2T) “一 
尹 (721,72) = 屎 (21, 2)W(21, 12) 
See Also conv2, filter2, fsamp2, freqspace, ftrans2, fwind1 


Reference [Lim, Jae S. 7Tzo-DimazemzsiozzalL Sis7al aa 11rase Processi15. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 202-213. 
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getheight 





Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 


Get height of structuring element 


H = getheight(SE) 

H = getheight(SE) returns an array the same Size as getnhood(SE) 
containing the height associated with each of the structuring element 
neighbors. H is all zeros for aflat structuring element. 


SE is a STREL object. H is of class doub1e. 


Se = Strel(ones(3,3) ,magic(3) ) ; 
getheight(se) 


strel, getnhood 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 
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Get image data 位 om axes 


A = getimage(h) 

[x,y,A] = getimage(h) 
[...,A,flag]l = getimage(h) 
[...] = getimage 


A = getimage(h) returns the first image data contained in the Handle 
Graphics object h. h can be a figure, axes, image, or texture-mapped surface. A 
is identical to the image CDatai; it contains the same values and is ofthe same 
class (uint8 or double) as the image CData. Ifh is not an image or does not 
contain an image or texture-mapped surface, A is empty. 


[x,y,A] = getimage(h) returnstheimage XDatainxandtheYDatainy.XData 
and YData are two-element vectors that indicate the range ofthe x-axis and 
y-aXiS, 

[...,A,flag]l = getimage(h) returns an integer flag that indicates the type 
of image h contains. This table summarizes the possible values for fl1ag. 








Flag Type of Image 

0 Not an image; Ais returned as an empty matrix 

1 Intensity image with values in standard range ([0,]1] for 
double arrays, [0,255] for uint8 arrays, [0,65535] for uint16 
arTrayS) 

2 Indexed image 

3 Intensity data, but not in standard range 

4 RGB image 





[...] = getimagereturns information for the current axes. It is equivalent to 
[...] = getimage(gcal). 


The output arrayAis ofthe same class as the image CData. All other inputs and 
outputs are of class doub1e. 


geftimage 





Example This example illustrates obtaining the image data from an image displayed 
directly from a file. 


Imshow rice.tif 
II = getimage; 
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PurPpose Get structuring element neighbor locations and heights 

Syntax [offsets,heights] = getneighbors(SE) 

Description [offsets,heights] = getneighbors(SE) returns the relative locations and 
corresponding heights for each of the neighbors in the structuring element 
object SE. 


offsets is aP-by-N array where P is the number ofneighbors in the 
structuring element and N is the dimensionajlity ofthe structuring element. 
卫 ach rovw of offsets contains the location of the corresponding neighbor， 
relative to the center of the structuring element. 


heights is aP-element column vector containing the height ofeach structuring 


element neighbor. 


Class Supporf  。  SEis a STREL object. The return values, offsets and heights, are arrays of 
double precision values. 


Example se = strel([10 1],[5 0 -5]) 
[offsets,heights] = getneighbors(se) 
Se = 


Nonf1lat STREL object containing 2 neighbors . 


Neighborhood : 
1 0 1 
Height : 
5 0 -5 
offsets = 
0 -1 
0 1 
heights = 
5 -5 
See Also strel, getnhood, getheight 
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Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 


Get structuring element neighborhood 


nhood = getnhood(SE) 


nhood = getnhood(SE) returns the neighborhood associated with the 
structuring element SE. 


SE is a STREL object. nhood is a 1ogical arTay. 


Se = Strel(eye(5) ) ; 
nhood = getnhood(se) 


strel, getneighbors 
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PurPpose 卫 xtract sequence of decomposed structuring elements 
Syntax SEQ = getsequence(SE) 
Description SEQ = getsedquence(SE), where SE is a structuring element array, returns 


another structuring element array SEQ containing the individual structuring 
elements that form the decomposition of SE. SEQ is equivalent to SE, but the 
elements of SEQ have no decomposition . 


Class Supportf 。 SE and SEQ are arrays of STREL objects. 


Example The strel function uses decomposition for square structuring elements larger 
than 3-by-3. Use getsequence to extract the decomposed structuring 
elements, 


Se = Strel(' square ,5) 

Seq = getsedquence(Se) 

Se = 

Flat STREL object containing 25 neighbors 

Decomposition: 2 STREL objects containing a total of 10 neighbors 


Neighborhood : 
1 


本 
证 计 二 二 下 基 由 二 时 二 让 
1 
本 和 二 区 和 
RE 


Seq = 
2x1 array of STREL objects 


Use imdilate with the 'ful1' option to seethat dilating sequentially with the 
decomposed structuring elements really does form a 5-by-5 square: 


imdilate(1,sedq，ful1') 


See Also imdilate, imerode, strel 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


See Also 


Convert an intensity image to an indexed image 


[X,map] 
[X,map] 


gray2ind(I,n) 
gray2ind(BW;,n) 


gray2ind scales, then rounds, an intengsity image to produce an equivalent 
indexed image, 


[X,map] = gray2ind(I,n) converts the intensity image Ito an indexed image 
X with colormap gray(n). Ifnis omitted, it defaults to 64. 


[X,map] = gray2ind(BW,n) converts the binary image, BW, to an indexed 
image, X, with colormap gray(n). Ifnis omitted, it defaults to 2. 


n must be an integer between 1 and 65536. 

The input image, IT, must be a real, nonsparse array of class 1ogical, uint8， 
uint16, or double. It can have any dimension. The class of the output imasge， 
X, is uint8 这 the colormap length is less than or equal to 256; otherwise it is 
uUint16. 


ind2gray 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


See Also 
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Create indexed image from intensity image using multilevel thresholding 


X = graySslice(I,n) 


X = graySlice(I,V) 
X = grayslice(I,n) thresholdqs the intensity image I using cutoff values 
1 工 2 刀 -1 ,returning an indexed image in X. 


X = grayslice(I,v),wherevis avector ofvalues between 0 and 1, thresholdqs 
I using the values of v, returning an indexed image in X. 


You can View the thresholded image using imshow(X,map) with a colormap of 
appropriate length. 


The input image, I, can be ofclass uint8, uint16, or doubp1e. Note that the 
threshold values are always between 0 and 1l, even 计 Iis ofclass uint8 or 
uint16. In this case, each threshold value is multiplied by 255 or 65535 to 
determine the actual threshold to use. 


The class ofthe output image, X, depends on the number ofthreshold values， 
as specified byn or length(v). Ifthe number ofthreshold values is less than 
256,then Xis ofclass uint8,andthevalues inXrangefomoOotonor Ilength(v). 
Ifthe number ofthreshold values is 256 or greater, X js ofclass double, and the 
values in Xrange from lto n+1 or length(v)+1. 


I = imread(' ngc4024m.tif ) ; 
X = graySlice(I,16) ; 
imshow(I) 
figure，imshow(X,jet(16)) 





gray2ind 


grayfthresh 





Purpose 
Syntax 


Descripfion 


Class Suppor 


See Also 


Reference 


Compute global image threshold using Otsu's method 

level = graythresh(I) 

level = graythresh(I) computes a global threshold (Level)that can be used 
to convert an intensity image to a binary image with im2bw. 


level is anormalized intensity value that lies in the range [0，1]. 


The graythresh function uses Otsus method, which chooses the threshold to 
minimize the intraclass variance ofthe black and white pixels. 


Multidimensional arrays are converted automatically to 2-D arrays Using 
reshape. The graythresh function ignores any nonzero imaginary part of I. 


The input image, I, can be of class uint8, uint16, or double and it must be 
nonsparse. The return value, Ilevel, is a double scalar. 


Im2bw 


N. Otsu “A Threshold S$election Method from Gray-Level Histograms,”7 五 玖 
77ra7sactzos o1 9Syste1s, Ma71 aa Cyper7etics, vol. 9, no. 1 pp. 62-66, 1979. 
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PurPpose 


Syntax 


Descripfion 
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Enhance contrast using histogram equalization 


Jd = histeq(I,hgram) 
d histeq(I，n) 
[J,T] = histeq(I,，...) 


newmap = histeq(X,map,hgram) 
newmap = histeq(X,map) 
[newmap ,T] = histeq(X,，...) 


histeq enhances the contrast of images by transforming the values in an 
intensity image, orthe values in the colormap of an indexed image, so thatthe 
histogram ofthe output image approximately matches a specified histogram. 


J = histeq(I,hgram) transforms the intengsity image I sothat the histogram 
of the output intensity image J with length(hgram) bins approximately 
matches hgram. The vector hgram should contain integer counts for equally 
spaced bins with intengsity values in the appropriate range: [0, 1] for images of 
class double, [0, 255] for images of class uint8, and [0, 65535] for images of 
class uint16. histeq automatically scales hgram so that sum(hgram) = 
prod(size(I)).The histogram of J will better match hgram when 
length(hgram) is much smaller than the number of discrete levels in 工 . 


J = histedq(I,n) transforms the intensity image I, returning in J an intensity 
image with n discrete gray levels. Aroughly equal number of pixels is mapped 
to each ofthe n levels in J, so thatthe histogram of J is approximatelyflat. (The 
histogram of J is flatter when n is much smaller than the number of discrete 
levels in I.) The default value for n is 64. 


[J,T] = histeq(I,...) returnsthe grayscale transformation that maps gray 
levels in the intengsity image Ito gray levels in J. 


newmap = histeq(X,map,hgram) transforms the colormap associated with the 
indexed image X so that the histogram ofthe gray component of the indexed 
image (X,newmap) approximately matches hgram. The histeq fanction returns 
the transformed colormap in newmap. Ilength(hgram) must be the same as 
Size(map,1). 


histeq 





Class Suppor 


Example 


newmap = histeq(X,map) transforms the values in the colormap so that the 
histogram ofthe gray component ofthe indexed image X is approximately flat. 
It returns the transformed colormap in newmap. 


[newmap,T] = histeq(X,...) returns the grayscale transformation Tthat 
maps the gray component of map to the gray component of newmap. 


For syntaxes that include an intensity image I as input, Icanbe ofclass uint8， 
uint16, or double, and the output image J has the same class as I. For 
Syntaxes that include an indexed image X as input, X can be of class uint8 or 
double; the output colormap is always ofclass double.Also,the optional output 
T (the gray level transform) is always of class doub1e. 


Enhance the contrast of an intengsity image using histogram equalization. 


I= imnread( tire.tif ' ) ; 
J = histeq(I) ; 
Imshow(I) 
figure，imshow(J) 





Display the resulting histogrames， 


imhist(I,64) 
figure; imhist(J,64) 
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Algorithm 


See Also 
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When you supply a desired histogram hgram, histeq chooses the grayscale 
transformation 7 to minimize 


eai(TCBD)) -eco 


where coils the cumulative histogram ofA, cl is the cumulative sum of hgram for 
all intensities 上 . This minimization is subject to the constraints that7mustbe 
monotonic and cl(7f(oj) cannot overshoot cof(aw) by more than halfthe distance 
between the histogram counts at a. histeq uses this transformation to map the 
gray levels in X (or the colormap) to their new values. 


D = 了 (a) 
If you do not specify hgram, histedq creates aflat hgram， 
hgram = ones(1,n)*prod(size(A) ) /ni 


and then applies the previous algorithm. 


brighten, imadjust,，imhist 


hsv2rgb 





Purpose Convert hue-saturation-value (HSV) values to RGB color space 


hsv2rgb is a function in MATLAB. To get help for this function， select 
MATLAB Help from the Help menu and view the online fanction reference 


page. 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Algorithm 


See Also 


References 
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Compute two-dimensional inverse discrete cosine transform 


B = idct2(A) 
idct2(A;m;n) 
B = idct2(A,[mnl]) 


四 
中 


B = idct2(A) returns the two-dimensional inverse discrete cosine transform 
(DCT) of A. 


B = idct2(A,m,n) orB = idct2(A,[m n]) padqs A with zeros to Size m-by-n 
before transforming. If [m n] < size(A), idct2 crops Abefore transforming. 


For anyA,，idct2(dct2(A) ) equals Ato within roundoff error. 


The input matrix A can be ofclass double or of any numeric class. The output 
matrix Bis of class doub1e. 


idct2 computes the two-dimensional inverse DCT using 


M-1N=-L1 
二 (21+1)Dp ，T(22+1) 0<sm<s 必 -1 
4 = 3 opQaBpocos 217 COS EN 


DP=0agq=0 
| | 
”′ 和 LV 下 1<pxM-1l 7 LV 1<co<sN-1l 


dct2, dctmtXx, fft2，1fft2 
[Jain, Anil 民 . Faamzeptals of .DigSrital 1age Processi11S. Englewood Cliffs， 
NJ: Prentice Hall, 1989. pp. 150-153. 


[2] Pennebaker, William B., and Joan 工 . Mitchell. .JPEG: S41L Taase Data 
Comzpressiom Stanadarad. New York: Van Nostrand Reinhold, 1993. 


ifff2 





Purpose Compute two-dimensional inverse fast Fourier transform 


ifft2 is a function in MATLAB. To get help for this function, select MATLAB 
Help 位 om the Help menu and view the online function reference pages. 
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PurPpose Compute N-dqimensional inverse fast Fourier transform 


ifftn is a fanction in MATLAB. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference pages. 
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im2bw 





Purpose 


Synftax 


Descripfion 


Class Suppor 


Example 


Convert an image to a binary image, based on threshold 


BW = im2bw(I, Level) 
BW Im2bw(X,map ,1Level) 
BW = imn2bw(RGB,1Level) 


im2bw produces binary images 位 om indexed, intensity, or RGB images. To do 
this, it converts the input image to grayscale format (ifit is not already an 
intensity imnage), and then converts this grayscale image to binary by 
thresholding. The output binary image BWhas values of 0 (black) for all pixels 
in the input image with luminance less than level and 1 (white) for all other 
pixels. (Note that you specify level in therange [0,1,regardless ofthe class of 
the input image.) 


BW = im2bw(I,Level) converts the intengsity image I to black and white. 


BW = im2bw(X,map,1Level) converts the indexed image X with colormap map to 
black and white. 


BW = im2bw(RGB,1level) converts the RGB image RGB to black and white. 





Nofte The function graythresh can be used to compute the level argument 
automatically. 





The input image can be of class uint8, uint16, or double and it must be 
nonsparse. The output image, BW, is of class 1ogical. 


10ad trees 

BW = im2bw(X,map,0.4) ; 
Imshow(X,map) 
figure，imshow(BW) 
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See Also graythresh, ind2gray, rgb2gray 
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im2col 





Purpose 


Synftax 


Descripfion 


Class Suppor 


See Also 


Rearrange image blocks into columns 


B = im2col(A,[m n],byock type) 
= im2col(A,[m nl]) 
B = im2col(A，indexed ，...) 


中 


B = im2col(A,[m n],bIock type) rearranges image blocks into columns. 
bJIock_type is a string that can have one ofthese values: 


e 'distinct' for m-by-n distinct blocks 
e 'Sliding' for m-by-n slidqing blocks (default) 


B = im2col(A,[mn]l,，'distinct') rearranges each qistinct m-by-nblock in the 
imageAinto a column ofB. im2col pads A with zeros, 过 necessary, So its Size jg 
an integer multiple of m-by-n. 玉 A = [A11 A12;A21 A22], where each Aij i8 
m-by-n, thenB = [A11(:) A12(:) A21(:) A22(:)]. 


B = im2col(A,[mn]l,'sliding') converts each sliding m-by-n block ofAinto a 
column of B, with no zero padding. B has mx*n rowsgs and will contain as many 
columns as there are m-by-n neighborhoods ofA. Ifthe size ofAis [mm nn],then 
the size ofB is (mx*n)-by-((mm-m+1)*(nn-n+1) ). 


B = im2col(A,[m n]) uses the dqefault block_type of 'sLiding '. 


For the sliding block case, each column of B contaings the neighborhoods of A 
reshaped as nhood(: ) where nhood is a matrix containing an m-by-n 
neighborhood ofA. im2col orders the columns ofB so thatthey can be reshaped 
to form a matrix in the normal way. For example, suppose you use a function， 
such as sum(B), that returns a scalar for each column of B. You can directly 
store the result in a matrix of size (mm-m+1)-by-(nn-n+1), using these calls. 


B im2col(A,[m n]， sliding ) ; 
C = reshape(Ssum(B) ,mm-m+1,nn-n+1l) ; 


B = im2col(A，'indexed' ,...) processes Aas anindexedimage,padding with 
Zerogs ifthe class of Ais uint8, or ones ifthe class ofAis doub1e. 


The input image, A, can be numeric or logical. The output matrix, B, is of the 
same class as the input image. 


bl1kproc, coO1L2im, CO1Lfilt, nLfilter 
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PurPpose 


Syntax 


Descripfion 


See Also 
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Convert image array to double precision 


I2 = im2double(I1) 

RGB2 = im2double(RGB1) 

II = imn2double(BW) 

X2 = im2double(X1，indexed ') 


im2double takes an image as input, and returns an image of class double. 开 
the input image is ofclass double, the output image is identical to it. Ifthe 
input image is ofclass logical, uint8, or uint16, im2double returns the 
equivalent image of class double, rescaling or offsetting the data as necesSary、. 


I2 = im2double(I1) converts the intensity image I1 to double precision， 
rescaling the data ifnecessary， 


RGB2 = im2double(RGB1) converts the truecolor image RGB1 to double 
precision, rescaling the data 让 necessary. 


I = im2double(BW) converts the binary image BWto an intengsity image ofclass 
doub1e. 


X2 = im2double(X1，indexed') converts the indexed image X1 to double 
precision, offsetting the data 这 necessary， 


doub1le, im2uint8, uint8 


im2iava 





Purpose Convert image to Java image 


im2java is a MATLAB function. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference pages. 
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PurPpose 


Syntax 


Descripfion 


See Also 
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Convert image array to eight-bit unsigned integers 


I2 = im2uint8(I1) 

RGB2 = im2uint8(RGB1) 

I = imn2uint8(BW) 

X2 = im2uint8(X1，indexed ' ) 


im2uint8 takes an image as input, and returns an image of class uint8. Ifthe 
input image is ofclass uint8, the output image is identical to it. Ifthe input 
image is ofclass 1ogical, uint16, or double, im2uint8 returns the equivalent 
image of class uint8, rescaling or offsetting the data as necesSsary， 


I2 = im2uint8(I1) converts the intengsity image I1 to uint8, rescaling the 
data 这 necessary， 


RGB2 = im2uint8(RGB1) converts the truecolor image RGB1 to uint8, rescaling 
the data ifnecessary， 


I = im2uint8(BW) converts the binary image BW to an intensity image of class 
Uint8. 


X2 = im2uint8(X1，indexed' ) converts the indexed image X1 to uint8， 
offsetting the data 让 necessary. Note that it is not always possible to convert 
an indexed imageto uint8.IfXx1is ofclass double, max(X1(:)) mustbe256or 
less; 计 X1 is ofclass uint16, max(X1(:)) mustbe 255 or less. To convert a 
uint16 indexed image to uint8 byreducing thenumber ofcolors, use imapprox， 


Im2uint16, double, im2double, uint8, Imapprox, Uint16 


im2uint16 





Purpose 


Syntax 


Descripfion 


See Also 


Convert image array to 16-bit unsigned integers 


I2 = im2uint16(I1) 

RGB2 = im2uint16(RGB1) 

II = imn2uint16(BW) 

X2 = im2uint16(X1，indexed ') 


im2uint16 takes an image as input, and returns an image of class uint16. 开 
the input image is ofclass uint16, the output image is identical to it. Ifthe 
input image is ofclass double or uint8, im2uint16 returns the equivalent 
image of class uint16, rescaling or offsetting the data as necesSary. 


I2 = im2uint16(I1) converts the intensity image I1to uint16, rescaling the 
data 这 necesSary， 


RGB2 = im2uint16(RGB1) converts the truecolor image RGB1 to uint16， 
rescaling the data ifnecessary， 


I = im2uint16(BW) converts the binary image BWto an intengsity image ofclass 
Uint16. 


X2 = im2uint16(X1，indexed' ) converts the indexed image X1 to uint16， 
offsetting the data 让 necessary. Note that it is not always possible to convert 
an indexed image to uint16.IfX1is ofclass double,max(Xx1(:)) mustbe65536 
oOT less. 





Nofte im2uint16 does not Support binary images. 





Im2uint8, doub1le, im2doubJle, Uint8, uint16,， imapprox 
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PurPpose 
Syntax 


Descripfion 


Examples 


See also 
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Compute absolute difference of two images 
Z = imabsdiff(X,Y) 


Z=imabsdiff(X,Y) subtracts each element in arTray Y 位 om the corresponding 
element in array X and returns the absolute difference in the corresponding 
element ofthe output array Z.X and Y are real, nonsparse numeric arrays With 
the same class and size.Zhas the same class and size as XandY.IfXandyYare 
integer arrays, elements in the outputthat exceed therange ofthe integertype 
are truncated. 


IfX and Y are double arrays, you can use the expression abs(X-Y) instead of 
this function. 


This example calculates the absolute difference between two uint8 arTraysS. 
Note that the absolute value prevents negative values 位 om being rounded to 
Zero in the result, as they are with imsubtract. 


X = Uint8([ 255 10 75; 44 225 100] ) ; 
Y = Uint8([ 50 50 50j 50 50 50 ]) 
Z= imabsdiff(X,Y) 


辽 ; 过 
205 40 25 
6 175 50 


Display the absolute difference between a filtered image and the original. 


I = imread('cameraman.tif ' ) ; 

d Uint8(filter2(fspecial('gaussian' )， 工 ) ) ; 
K = imabsdiff(I,J) 

imshow(K,[]) 点 [] = Scale data automatically 


imadd,， imcomp1lement,， imdivide，imlincomb， immu1ltiply,， imsubtract 


imadd 





Purpose Add two images, or add a constant to an image 
Synftax Z = imadd(X,Y) 
Descripfion Z = imadd(X,Y) adds each element in array X with the corresponding element 


in array Y and returns the sum in the corresponding element of the output 
array Z. X and Y are real, nonsparse numeric arrays with the same Size and 
class,orYis ascalar double. The array returned, Z,has the same Size and class， 
or Yis a scalar double. Z has the same size and class as X. 


IX andyY are integer arrays, elements in the output that exceed the range of 
the integer type are truncated, and fractional values are rounded. 


IX andyY are double arrays, you can use the expression X+Y instead of this 
foanction. 


Examples Add two uint8 arrays. Note the truncation that occurs when the values exceed 
255. 


X = Uint8([ 255 0 75; 44 225 100]) ; 
Y = Uint8([ 50 50 50; 50 50 50 ]) 
Z= imnadd(Xx,Y) 
忆 


255 50 125 
94 ”255 150 


Add two images together and specify an output class. 


I= imnread(' Price.tif ' ) ; 

J= imread(' cameraman.tif ' ) ; 
K = imadd(I,J，uint16 '  ) ; 
Imshow(K, []) 


Add a constant to an image. 


I = imnread( rice.tif ' ) ; 
J= imadd(I,50) 
Subplot(1,2,1)，imshow(I) 
Subplot(1,2;,2)，imshow(Jy) 


See also imabsdiff, imcompJlIement,，imdivide,， imlincomb,，immu1ltiply，imsubtract 
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imadiust 





PurPpose 


Syntax 


Descripfion 
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Adjust image intensity values or colormap 


J= imadjust(I,[LIow_ in high_in],[lLlow out high_out],gammal) 
newmap = imadjust(map,[Jow_ in high_in],[Low out high_out],gammay) 
RGB2 = imadjust(RGB1,...) 


J = imadjust(I,[Llow in high_in],[LIow out high_out],gamma) maps the 
values in intensity image I tonew values in Jsuch thatvaluesbetween low_in 
and high_in map to values between Low _out and high_out. Values below 
low_in and above high_in are clijpped; that is, values below low_in map to 
Low_out, and those above high_in map to high_out. You can use an empty 
matrix ([])for [low_ in high_in] or for [Low_out high_out] to specify the 
default of [0 1]. 


gamma specifies the shape ofthe curve describing the relationship between the 
values in I and J. If gamma is less than 1, the mapping is weighted toward 
higher (brighter) output values. If gamma is greater than 1, the mapping is 
weightedtoward lower (darker) outputvalues. Ifyou omitthe argument, gamma 
defaults to 1 (linear mapping). 


newmap = imadjust(map,[Jow_ in; high_in],[Low_ out;high_out],gammay) 
trangsforms the colormap associated with an indexed image.Iflow in,high_in， 
Low_out, high_out, and gamma are scalars, then the same mapping applies to 
red, green and blue components. Unique mappings for each color component 
are possible when 


Low_in and high_in are both 1-by-3 vectors 
Low_ out and high_out are both 1-by-3 vectors, or gamma is a 1-by-3 vector. 
The rescaled colormap, newmap, is the same Size as map. 


RGB2 = imadjust(RGB1,...) performs the adjustment on each image plane 
(red, green, and blue) ofthe RGB image RGB1. As with the colormap 
adjustment, you can apply unique mappings to each plane, 





Note Ifhigh_ out < low out, the output image is reversed, as in a 
photographic negative. 





imadiust 





The function stretchlimcan beused with imadjust to apply an automatically 
computed contrast stretch . 


Class Supporf For syntax variationsthatinclude an inputimage (ratherthan acolormap),the 
input image can be ofclass uint8, uint16, or double. The output image has the 
same class as the input image. For syntax variationgs that include a colormap， 
the input and output colormaps are of class doub1e. 


Example I = imread('pout.tif'); 
J= imadjust(I,[0.3 0.7],[]); 
Imshow(I)，Tfigure，imshow(Jy ) 





RGB1 = imread( ' flowers.tif' ) ; 
RGB2 = imadjust(RGB1,[.2 .3 0; .6 .7 1],[]); 
imshow(RGB1)，figure，imshow(RGB2) 
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See Also brighten, histeq, stretch1lLinm 
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imaPpProx 





Purpose 


Synftax 


Descripfion 


Class Suppor 


Algorithm 


See Also 


Approximate indexed image by one with fewer colors 


[Y,newmap] = imapprox(X,map;n) 
[Y,newmap] = imapprox(X,map,tol) 

Y = imapprox(X,map,newmap ) 

[...] = imapprox(.. .ozther optIzon) 


[Y,newmap] = imapprox(X,map,n) approximates the colors in the indexed 
image X and associated colormap map by using minimum variance 
quantization. imapprox returns indexed image Y with colormap newmap, which 
has at most n colors. 


[Y,newmap] = imapprox(X,map,to1l) approximates the colors in X and map 
through uniform quantization. newmap contains at most (floor(1/tol)+1)^3 
colors. tol must be between 0 and 1.0. 


Y = imapprox(X,map,newmap) approximates the colors in map by using 
colormap mapping to find the colors in newmap thatbest match the colors in map. 


Y = imapprox(...,qzther option) enables or disables qithering、. 
dzther_option is a string that can have one ofthese values: 


e 'dither' dqithers, 让 necessary, to achieve better color resolution at the 
expense of spatial resolution (default). 


se 'nodither' maps each color in the original image to the closest color in the 
new map. No dithering is performed. 


The input image, X, can be ofclass uint8, uint16, or doub1le. The output image 
Yis of class uint8 这 the length of newmap is less than or equal to 256. Ifthe 
length of newmap is greater than 256, X is of class doub1le. 


imapprox uses rgb2ind to create a new colormap that uses fewer colors. 


cmunidque, qither, rgb2ind 
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imbofthat 





Purpose 


Syntax 


Descriptiion 


Class Suppor 


Example 
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Perform bottom-hat filtering 


IM2 imbothat (IM,SE ) 
IM2 = imbothat(IM,NHOOD ) 


IM2 = imbothat(IM,SE) performs morphological bottom-hat fltering on the 
grayscale or binary input image, IM, returning the filtered image, IM2. The 
argument SE is a structuring element returned by the strel function. SE must 
be a single structuring element object, not an array containing multiple 
structuring element objects. 


IM2 = imbothat(IM,NHOOD) performs morphological bottom hatfiltering where 
NHOOD is an array of 0's and 1s that specifies the size and shape ofthe 
structuring element. This is equivalent to imbothat(IM,strel(NHOOD) ). 


IM can be numeric or logical and must be nonsparse. The output image has the 
same class as the input image. Ifthe input is binary (logical)j, then the 
structuring element must be flat. 


Top-hat and bottom-hat filtering can be used together to enhance contrast in 
an Image， 
1 Read the image into the MATLAB workspace. 


I= imread('pout.tif ' ); 
imshow(I)，title(' original ) 





imbothat 





2 Add the original image to the top-hat filtered image, and then subtract the 
bottom-hat filtered image. 


Se = Strel(' disk ' ,3) ; 
J= imsubtract(imadd(I,imtophat(I,Sse))，imbothat(I,Se) ); 
figure，imshow(J)，title(' Contrast filtered ) 





See Also imtophat, strel 
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PurPpose 


Syntax 


Descripfion 
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Suppress light structures connected to image border 


IM2 = imclearborder(IM) 
IM2 = imclearborder(IM,CONN) 


IM2 = imclearborder(IM) Suppresses Structures that are lighter than their 
SuUrroundings and that are connected to the image border. IM can be an 
intensity or binary image. The output image, IM2， is intengsity or binary， 
respectively. The default connectivity is 8 for two dimensions, 26 for three 
dmensions, and conndef(ndims(BW) ，maximal') for higher dimensions. 





Nofte For intensity images, imclearborder tends to reduce the overall 
intensity level in addition to sSuppressing border Structures. 





IM2 = imclearborder(IM,CONN) specifies the desired connectivity. CONN may 
have any of the following scalar values. 





Value Meaning 





Two-dimensional connectivities 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may also be defined in a more general way for any dimension by 
using for CONN a 3-by-3-by- … -by-3 matrix of 0's and 1"S. The 1-valued elements 
define neighborhood locationgs relative to the center element of CONN. Note that 
CONN must be symmetric about its center element. 


imclearborder 








Nofte A pixel on the edge ofthe input image might not be considered to be a 
“bordqer” pixel ianondefault connectivity is specified. For example, ifconn = 
[0 0 0; 111;000l,elements onthefrstandlastrow arenot considered 
to be border pixels because, according to that connectivity definition, they are 
not connected to the region outside of the imasge. 





Class Supporf IMcan beanumeric or logical array ofany dimension, anditmustbenonsparse 
and real. IM2 has the same class as IM. 


Example The following examples use this simple binary image to jllustrate the effect of 
of imclearborder when you specify different connectivities. 
BW = 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
1 0 0 1 1 1 0 0 0 
0 1 0 1 1 1 0 0 0 
0 0 0 1 1 1 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 


Using a 4-connected neighborhood, the pixel at (5,2) is not considered 
connected to the border pixel (4,1), soit is not cleared. 


BWc1 = imclearborder(BW,4) 
BWoc 1 


= 
口 口 口 口 一 口 口 口 口 
| 
口 口 口 一 一 一 口 口 口 
口 口 口 一 一 一 口 口 口 
口 口 口 一 一 一 口 口 口 
DOoOoooooODODOD 
人 
DOoooDooOeODDOD 
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Using an 8-connected neighborhood, pixel (5,2) is considered connected to 
pixel (4,1) so both are cleared. 


BWc2 = imclearborder(BW,8) 


BWCc2 = 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 1 1 1 0 0 0 
0 0 0 1 1 1 0 0 0 
0 0 0 1 1 1 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 
Algorithm imclearborder uses morphological reconstruction where: 


se the mask image is the input image 


e the marker image is zero everywhere except along the border, where 进 
equals the mask image 


See Also conndef 


Reference [HP. Soille, MorpAolosical Jrzage A7alysis: Pripciples aa ApplLicatio7ms， 
Springer, 1999, pp. 164-165. 
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imclose 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Close an image 


IM2 = imclose(IM,SE) 
IM2 = imclose(IM,NHOOD ) 


IM2 = imclose(IM,SE) performs morphological closing on the grayscale or 
binary image IM, returning the closed image, IM2. The structuring element, SE， 
must be a single structuring element object, as opposed to an array of objects. 


IM2 = imclose(IM,NHOOD) performs closing with the structuring element 
strel(NHO0D), where NHOOD is an array of 0's and ls that specifies the 
structuring element neighborhood. 


IM can be any numeric or logical class and any dimension, and must be 
Donsparse. If IM is logical, then SE must be flat. IM2 has the same class as IM. 


This examples closes an image to merge together the small features in the 
image that are close together. The example then opens the image to removethe 
isolated white pixels. 


1 Read the image into the MATLAB workspace and threshold 让 . 


I= imnread(' pearlite.tif ' ) ; 
bw = ~iIim2bw(I,graythresh(I) ) ; 
figure，imshow(bw)，title('Step 1: threshold ) 


14-189 





可 





2 Close the image with a a disk-shaped structuring element. 


Strel( disk' ,6) ; 


Se 
bw2 


(bw,Se) ; 


Imcl1ose 


CloSsing ') 


figure，imshow(bw2)，title(' Step 2: 
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3 Open the image with the same structuring element. 
bw3 = imopen(bw2,Se) ; 
figure，imshow(bw3)，title('Step 3: opening ') 


病 
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See Also Imopen, imdilate， imerode, Strel 
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imcomplement 





Purpose 
Syntax 


Descripfion 


Examples 


Complement image 
IM2 = imcomp1Llement(IM) 


IM2 = imcomplement(IM) computes the complement ofthe image IM. IM can be 
abinary, intensity, or RGB image. IM2 has the same class and Size as IM. 


In the complement of a binary image, zeros becomes ones and ones become 
Zeros; black and white are reversed. In the complement of an intensity or RGB 
image, each pixel value is subtracted from the maximum pixel value Supported 
by the class (or 1.0 for double-precision images) and the difference is used as 
the pixel value in the output image. In the output image, dark areas become 
lighter and light areas become darker. 





Note IfIMis an intensity or RGB image ofclass double, you can use the 
expression 1-IM instead ofthis function. If IM is a binary image, you can use 
the expression ~IM instead ofthis fanction. 





Create the complement of a uint8 array， 


X = Uint8([ 255 10 75;j 44 225 100] ) ; 
X2 = imcomplement(X) 
X2 


0 ”245 180 
211 30 155 


Reverse black and white in a binary image. 


bw = imread( text.tif ' ) ; 
bw2 = imcomplement(bw) ; 
Subplot(1,2,1),imshow(bw) 
Subplot(1,2,2),imshow(bw2) 


Create the complement of an intensity image. 


II = imnread(' bonemarr.tif ' ) 
J= imcomp(I); 
Imshow(I)，figure，ijimshow(JU ) 
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See Also imabsdiff,， imadd, imdivide， imlzncomb,，immultiply，imsubtract 
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Imconftour 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Create a contour plot ofimnage data 


imcontour(I,n) 
imcontour(I,V) 
Imcontour(x,y，...) 
Imcontour(...，LineSpec ) 
[C,h] = imcontour(...) 


imcontour(I,n) draws a contour plot ofthe intensity image I, automatically 
setting up the axes so their orientation and aspect ratio match the image. n is 
the number ofequally spaced contour levels in the plot; 寺 you omit the 
argument, the number of levels and the values of the levels are chosen 
automatically. 


imcontour(I,v) draws acontour plot of I with contour lines atthe data values 
specified in vector v. The number of contour levels is equal to length(v ). 


imcontour(x,y,...)usesthevectors xandytospecifythex- andy-axis limits. 


imcontour(...,LineSpec) draws the contours using the line type and color 
specified by LineSpec. Marker Symbols are ignored. 


[C,h] = imcontour(...) returns the contour matrix C and a vector ofhandles 
to the objects in the plot. (The objects are actually patches, and the lines are 
the edges ofthe patches.) You can use the clabel function with the contour 
matrix C to add contour labels to the plot. 


The input image can be ofclass uint8, uint16, double, or 1ogical. 


II = imnread( ic.tif ' ); 
imcontour(I,3) 
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Inmcontfour 





























See Also clabel, contour, LineSpec in the MATLAB Function Reference 
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Purpose 


Syntax 


Descripfion 


Crop an image 


I2 = imcrop(I) 
X2 = imcrop(X,map) 
RGB2 = imcrop(RGB) 


I2 = imcrop(I,rect) 
X2 = imcrop(X,map,rect) 
RGB2 = imcrop(RGB ,rect) 


[...] = imcrop(x,y,，..,) 
[A,rect] = imcrop(...) 
[x,y, Arect] = imcrop(...) 


imcrop crops an image to a specified rectangle. In the syntaxes below, imcrop 
displays the input image and waits for you to specify the crop rectangle with 
the mouse. 


I2 = imcrop(I) 
X2 = imcrop(X,map) 
RGB2 = imcrop(RGB) 


I 节 you omit the input arguments, imcrop operates on the image in the current 
aXeS. 


To specify the rectangle: 
e For a single-button mouse, press the mouse button and drag to define the 
crop rectangle. Finish by releasing the mouse button. 


e Fora2-or 3-button mouse, press the left mouse button and drag to define 
the crop rectangle. Finish by releasing the mouse button. 


Ifyou hold down the Shift key while dragging, or 让 you press the right mouse 
button on a2- or 3-button mouse, imcrop constrains the bounding rectangle to 
be a square， 


When you release the mouse button, imcrop returns the cropped image in the 
Supplied output argument. Ifyou do not supply an output argument，imcrop 
displays the output image in a new figure. 
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Class Suppor 


Remarks 


Example 
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You can also specify the cropping rectangle noninteractively, using these 
SyntaxeSs 


I2 = imcrop(I,rect) 
X2 = imcrop(X,map,rect) 
RGB2 = imcrop(RGB ,rect) 


rect is a four-element vector with the form [xmin ymin width height];these 
values are specified in spatial coordinates. 


To specify anondefault spatial coordinate system for the input image, precede 
the other input arguments with two, two-element vectors specifying the XData 
and YData. For example， 


[...] = imncrop(x,y，...) 


Ifyou supply additional output arguments, imcrop returns information about 
the selected rectangle and the coordinate System of the input image. For 
example， 


[A,rect] = imcrop(...) 
[x,y,A,rect] = imcrop(...) 


Ais the output image. x and y are the XData and YData of the input image. 


The input image Acan be ofclass logical, uint8, uint16, or double. The 
output image Bis ofthe same class as A. rect is always of class doub1le. 


Because rect is specified in terms of spatial coordinates, the width and height 
elements of rect do not always correspond exactly with the size ofthe output 
image. For example, suppose rect is [20 20 40 30], using the default spatial 
coordinate System. The upper-left corner ofthe specified rectangle is the center 
ofthe pixel (20,20) and the lower-right corner is the center ofthe pixel (50,60). 
Theresultingoutput image is 31-by-41,not 30-by-40, becausethe output image 
includes all pixels in the input image that are completely or partially enclosed 
by the rectangle. 


I = imread(' ic.tif' ); 

I2 = imcrop(I,[60 40 100 901]) ; 
imshow(I) 

figure，imshow(I2) 


imcrop 








See Also zoom 


14-199 


imdilate 





PurPpose 


Syntax 


Descripfion 
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Dilate image 


IM2 = imdilate(IM,SE) 

IM2 = imdilate(IM,NHOOD ) 

IM2 = imdilate(IM,SE,PACKOPT ) 
IM2 = imdilate(...,PADOPT) 


IM2 = imdilate(IM,SE) qilates the grayscale, binary, or packed binary image 
IM, returning the dilated image, IM2. The argument SE is a structuring element 
object, or array of structuring element objects, returned by the strel function. 


HI 节 IM is logical and the structuring element is flat, imdilate performs binary 
dilation; otherwise, it performs grayscale dilation. IfSE is an array of 
structuring element objects, imdilate performs multiple qilations ofthe input 
image, using each structuring element in SE in succession . 


IM2 = imdilate(IM;,NHOOD) dqilates the image IM, where NHOOD is a matrix of 
0's and ls that specifies the structuring element neighborhood. This is 
equivalent to the syntax imdilate(IM,strel(NHOOD)).The imdilate fanction 
determines the center element of the neighborhood by 
floor((Size(NHOOD)+1)/2). 


IM2 = imdilate(IM,SE,PACKOPT) or imdilate(IM,NHO0OD,PACKOPT) specifies 
whether IMis a packed binary image. PACKOPT can have either ofthe following 
values， 





'ispacked ' IM is treated as a packed binary image as produced by 
bwpack. IM must bea2-Duint32 array and SE must be a 
flat 2-D structuring element. Ifthe value of PACKOPT ig 
'ispacked', PADOPT must be 'same '. 


"notpacked'” IMis treated as anormal arTray. This is the default value. 





imdilate 





Class Suppor 


Examples 


IM2 = imdilate(...,PADOPT) specifies the size ofthe output image. PADOPT 
can have either ofthe following values. 





“Same' Make the output image the same size as the input image. 
This is the default value. Ifthe value of PACKOPT is 
'ispacked', PADOPT must be 'same ' . 


fu11， Compute the full qilation. 





PADOPT is analogous to the optional SHAPE argument to the conv2 and filter2 
fanctions， 


IM can be logical or numeric and must be real and nonsparse. It can have any 
dimension. IfIMis logical, SEmustbeflat.The outputhasthe sameclass as the 
input. 玉 the input is packed binary, then the output is also packed binary. 


This example dilates a binary image with a vertical line structuring element. 


bw = imread( text.tif ' ) ; 

Se Strel(' 1Line' ,11,90) 

bw2 = imdilate(bw,se) ; 
imshow(bw)，title( original ') 
figure，imshow(bw2)，title('Dilated ') 


To Locate 所 玉 nOoWT 贞 二 轴 攻 
Target in an Image 天 有 寺 顷 山 风 


This example dilates a grayscale image with arolling ball structuring element. 


Cross-Coffrelation Used 和 
人 有 


50 
耻 
4 
对 山口 
号 总 己 
色 马 召 
) 
员 妃 包 
| 
慌 ; 这 后 





II = imnread( cameraman.tif ' ) ; 
Se = Strel('bal1' ,5,5) 
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I2 = imdilate(I,Se); 
Imshow(I)，title(' original ) 
figure，imshow(I2)，title('Dilated ') 





To determine the domain ofthe composition of two flat structuring elements， 
dilate the scalar value 1 with both structuring elements in sequence, using the 
'fu1L1' option. 


Se1 = Strel(' line' ,3);0) 
Se1 = 


Flat STREL object containing 3 neighbors . 


Neighborhood : 
1 1 1 
Se2 = Strel(' Line' ,3,90) 


Se62 


Flat STREL object containing 3 neighbors . 
Neighborhood : 

1 

1 

1 


Composition = imdilate(1,[se1 se2]，ful1 ') 


Composition = 
1 1 1 
1 1 1 
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Algorithm 


See Also 


References 


imdilate automatically takes advantage ofthe decomposition of a structuring 
element object Gfit exists). Also, when performing binary dilation with a 
structuring element object that has a decomposition, imdilate automatically 
uses binary image packing to speed up the dilation. 


Dilation using bit packing is qdqescribed in [2]. 
bwpack, bwunpack, conv2, filter2, imclose, Imerode, imopen, strel 


[Robert M. Haralick and Linda G. Shapiro, Co72pzter azQ 尺 opot Visio7, vol. 
LI Addison-Wesley, 1992, pp. 158-205. 


[2] van den Boomgaard and van Balen，“Image Transforms Using Bitmapped 
Binary Images,”Comzpxter Visio1， Graphzics, a12Q 7112aSe Process1105: GrapPzca1 
Moaels aa 17rase Processins, vol. 54, no. 3, May, 1992, pp. 254-258. 
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PurPpose 
Syntax 


Descripfion 


Example 


See Also 


14-204 


Divide one image into another, or divide an image by a constant 


Z = imdivide(X,Y) 


Z = imdqivide(X,Y) divides each element in the array X by the corresponding 
element in array Y and returns the result in the corresponding element of the 
output array Z. X and Y are real, nonsparse numeric arrays with the same size 
and class, or Y can be a scalar double. Z has the same size and class as X and Y. 


IfXis an integer array, elements in the output that exceed the range of integer 
type are truncated, and fractional values are rounded. 


IfX and Y are double arrays, you can use the expression X./Y instead of this 
fanction,， 


Divide two uint8 arrays. Note that fractional values greater than or equal to 
0.5 are rounded up to the nearest integer. 


X = uint8([ 255 10 75; 44 225 100] ) ; 
Y = uint8([ 50 20 50; 50 50 50 ]); 
Z = imdivide(X,Y) 
Z 


5 1 2 
1 5 2 


了 stimate and divide out the background of the rice imasge. 


I = imread(' Price.tif ' ); 

blocks = blkproc(I,[32 32]，min(x(:)) ); 

background = imresize(blocks,[256 256]，bilinear ) ; 

IP = imdqivide(I,background ) ; 

imshow(Ip,[]) 点 [] = let imshow Scale data automatically 


Divide an image by a constant factor. 
I = imread(' rice.tif ' ) ; 
J = imdivide(I,2); 
Subplot(1,2,1)，imshow(I) 
Subplot(1,2,2)，imshow(Jy) 


imabsdiff,， imadd， imcomp1lement, imlincomb,， immultiplLy，imsubtract 


imerode 





Purpose 


Synftax 


Descripfion 


Erode image 


IM2 = imerode(IM,SE) 

IM2 = imerode(IM,NHOOD ) 

IM2 = imerode(IM,SE,PACKOPT ,M) 
IM2 = imerode(...,，PADOPT) 


IM2 = imerode(IM,SE) erodes the grayscale, binary, or packed binary image 
IM, returning the eroded image, IM2. The argument SEis a structuring element 
object, or array of structuring element objects, returned by the strel fonction. 


HI 节 IM is logical and the structuring element is flat, imerode performs binary 
dilation; otherwise it performs grayscale erosion. If SE is an array of 
structuring element objects, imerode performs multiple erosions of the input 
image, using each structuring element in SE in Succession. 


IM2 = imerode(IM,NHOOD) erodes the image IM, where NHOOD is an array of 0?S 
and 1"s that specifies the structuring element neighborhood. This is equivalent 
to the syntax imerode(IM,strel(NHO0D)). The imerode fanction determines 
the center element of the neighborhood by floor((size(NHOOD)+1)/12) 


IM2 = imerode(IM,SE,PACKOPT,M) or imerode(IM,NHOOD,PACKOPT ,MI) 
specifies whether IM is a packed binary image and, ifit is, provides the row 
dimension, M, of the original unpacked image. PACKOPT can have either ofthe 
following values. 





'ispacked ' IM is treated as a packed binary image as produced by 
bwpack. IM must bea2-Duint32 array and SE must be a 
fat 2-D structuring element. 


notpacked'” INMis treated as a normal array. This is the default value. 





IfPACKOPT is 'ispacked' ,you must specify a value for M. 
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IM2 = imerode(...,PADOPT) specifies the size ofthe output image. PADOPT can 
have either ofthe following values. 





“Same'， Make the output image the same size as the input image. 
This is the default value. Ifthe value of PACKOPT is 
'Ispacked', PADOPT must be 'same '. 


'fu11， Compute the full erosion. 





PADOPT is analogous to the SHAPE input to the CONV2 and FILTER2 fanctions， 


Class Support 。 IMcan be numeric or logical and it can be of any dimension. If IM is logical, SE 
mustbeflat. The output has the same class as the input. Ifthe input is packed 
binary, then the output is also packed binary、. 


Examples This example erodes a binary image with a vertical line. 


bw = imread( ' text.tif ' ) 

Se Strel('Line' ,11,90) ; 

bw2 = imerode(bw,Sse) 
imshow(bw)，title('original ') 
figure，imshow(bw2)，title(' Eroded ') 


Cfross-Cotrelation Used 
ToLocate 各 类 nowt 
Taregetin an Image 





bb0 
耻 
4 
对 山口 
呈 总 忆 
凶 马 召 
有 ) 
员 妃 包 
. 司 
巴 避 所 


This example erodes a grayscale image with a rolling ball. 


I = imread(' cameraman.tif ) ; 
Se = Strel('bal1' ,5,5) 
I2 = imerode(I,Se); 
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Algorithm 
Notes 


See Also 


References 


Imshow(I)，title('original ) 
figure，imshow(I2)，title(' Eroded ') 





imerode automatically takes advantage ofthe decomposition of a structuring 
element object (Gf a decomposition exists). Also, when performing binary 
dilation with a structuring element object that has a decomposition，imerode 
automatically uses binary image packing to speed up the dilation. 


Erosion using bit packing is described in [2]. 
bwpack, bwunpack, conv2, filter2, imclose,， imdilate， imopen,，Sstrel 


[Robert M. Haralick and Linda G. Shapiro, Co72Dpzxter azQ 尺 opot Visio7, vol. 
TI Addison-Wesley, 1992, pp. 158-205. 


[2] van den Boomgaard and van Balen，“Image Transforms Using Bitmapped 
Binary Images,”Comzpxter Visio1z， Graphzics, a12Q 7112aSe Process1105: GrapPzca1 
Moaels aa 17rase Processins, vol. 54, no. 3, May, 1992, pp. 254-258. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 
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Extended-maxima transform 


BW = imextendedmax(I,H) 


BW = imextendedmax(I,H) computes the extended-maxima transform, which 
is the regional maxima of the H-maxima transform. H is a nonnegative Scalar. 


Regional maxima are connected components of pixels with the same intensity 
value, 刀 whose external boundary pixels all have a value less than 上 


By default, imextendedmax uses 8-connected neighborhoods for 2-D images and 
26-connected neighborhoods for 3-D images. For higher dimensions， 
Imextendedmax uses conndef (ndims(I) ，maximal ' ). 


BW = imextendedmax(I,H,CONN) computes the extended-maxima transform， 
where CONN specifies the connectivity. CONN may have any of the following 
Scalar values. 





Value Meaning 





Two-dimensional connecfivifies 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborphood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of0's and 1's. The 1-valued elements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


I can be of any nonsparse numeric class and any dimension. BW has the same 
size as I and is always logical. 


imextendedmax 





Example I = imread('bonemarr.tif' ); 
BW = imextendedmax(I,40) ; 
imshow(I)，figure，imshow(BW) 


See Also conndef, imextendedmin，imreconstruct 


Reference [1 Pierre Soille, MorpPpolosrical 11aase APpzalysis: Primciples ad Applicatio7s， 
Springer-Verlag, 1999, pp. 170-1711. 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 
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Extended-minima transform 
BW = imextendedmin(I,h) 


BW = imextendedmin(I,h) computes the extended-minimatransform, which is 
the regional minima of the 再 -minima transform. h is a nonnegative Scalar. 


Regional minima are connected components of pixels with the same intensity 
value, 刀 whose external boundary pixels all have a value greater than 夺 . 


By default, imextendedmin uses 8-connected neighborhoods for 2-D imasges， 
and 26-connected neighborhoods for 3-D images. For higher qimensions， 
Imextendedmin uses conndef (ndims(I) ，maximal ' ). 


BW = imextendedmin(I,h;,CONN) computes the extended-minima transform， 
where CONN specifies the connectivity. CONN may have any of the following 
Scalar values. 





Value Meaning 





Two-dimensional connecfivifies 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborphood 
26 26-connected neighborphood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by-.…-by-3 matrix of 0's and 1's. The 1-valued elements define 
Deighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


I can be of any nonsparse numeric class and any dimension. BW has the same 
size as I and is always logical. 


imextendedmin 





Example I = imread('bonemarr.tif'); 
BW = Imextendedmin(I,10) ; 
imshow(I)，figure，imshow(BW) 


See Also conndef, imextendedmax，imreconstruct 


Reference [1 Pierre Soille, Morpjpolosrical 11aase Analysis: Primciples ad Applicatio7s， 
Springer-Verlag, 1999, pp. 170-1711. 
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PurPpose 


Syntax 


Descripfion 
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Compute feature measurements for image regiongs 





Note This function is obsolete and may be removed in future versions. Use 
regionprops instead. 





StatS 
StatS 


Imfeature(L,measurements ) 
Imfeature(L,measurementsn) 


stats = imfeature(L,measurements) computes a set of measurements for 
each labeled region in the label matrix L. Positive integer elements of 上 
correspond to different regions. For example, the set of elements of L equal to 
1 corresponds to region l; the set of elements of L equal to 2 corresponds to 
region 2; and so on. stats is a Structure array of length max(L(:)).The fieldqs 
ofthe structure array denote different measurements for each region,， as 
Specified by measurementsS. 


measurements can be a comma-separated list of strings, a cell array containing 
strings, the single string 'all',orthe single string 'basic'.The set ofvalid 
measurement strings includes the following. 





Area， "Image "EULerNumber 
"Centroid FilledImage- “EXtrema' 
"BoundingBox FilledArea， 'EquiVvDiameter 
'MajorAxisLength ConvexHUu11- 'SolLidity 
'MinorAxisLength ConvexImage “EXtent 
"ECcCcentricity ConveXxArea， “PiIXxelList， 
Orientation， 





Measurement strings are case insengsitive and can be abbreviated. 


Ifmeasurements is the string 'all',then all ofthe above measurements are 
computed. Ifmeasurements is not specified or ifit is the string“'basic' ,then 
these measurements are computed: 'Area'，'Centroid ,and 'BoundingBox '. 


imfeature 





Definifions 


stats = imfeature(L,measurementsin) specifies the type ofconnectivity used 
in computing the 'FilledImage'，'FilledArea' ,and 'EuUlLlerNumber， 
measurements. n can have avalue of either 4 or 8, where 4 specifies 
4-connected objects and 8 specifies 8-connected objects; 让 the argument is 
omijtted, it defaults to 8. 


'Area ' - Scalar; the actual number of pixels in the region. (This value may 
differ slightly 人 om the value returned by bwarea, which weights different 
patterns of pixels differently.) 


'Centroid ' -1-by-2 vector; thex- andy-coordinates ofthe center ofmass ofthe 
Teglion. 


'BoundingBox ' - 1-by-4 vector; the smallest rectangle that can contain the 
region. The format ofthe vector is [x y width height], where x and y are the 
X- and y-coordinates of the upper-left corner of the rectangle, and width and 
height are the width and height ofthe rectangle. Note that x and y are always 
noninteger values, because they are the spatial coordqinates for the upper-left 
corner of a pixel in the image; for example, ifthis pixel is the third pixel in the 
和 fth row of the image, then x = 2.5 and y = 4.5. 


This fgureillustrates the centroid andbounding box. The region consists ofthe 
white pixels; the green box is the bounding box, and the red dot is the centroid. 





'MajorAxisLength ' -SScalar; the length (in pixels) ofthe major axis of the 
ellipse that has the same second-moments as the region. 


'MinorAxisLength' - S$calar; the length (in pixels) ofthe minor axis of the 
ellipse that has the same second-moments as the region. 


'Eccentricity' 一 Scalar; the eccentricity ofthe ellipse that has the same 
second-moments as the region. The eccentricity is the ratio of the distance 
between the foci ofthe ellipse and its major axis length. The value is between 
0 and 1. (0 and 1 are degenerate cases; an ellipse whose eccentricity is 0 is 
actually a circle, while an ellipse whose eccentricity is 1 is a line Segment.) 
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'Orientation' -SScalar; the angle (in degrees) between the x-axis and the 
major axis of the ellipse that has the same second-moments as the region. 


This fgure illustrates the axes and orientation ofthe ellipse. The left side of 
the figure shows an image region and its corresponding ellipse. The right side 
shows the same ellipse, with features indicated graphically; the solid blue lines 
are the axes, the red dots are the foci, and the orientation is the angle between 
the horizontal dotted line and the major axis. 





Image ' -Binary image ofthe same size as the bounding box ofthe region; the 
on pixels correspond to the region, and all other pixels are off. 


'FilledImage' -Binary image ofthe same Size as the bounding box of the 
region; the on pixels correspond to the region, with all holes filled in. 


'FilledArea' -SScalar; the number of on pixels in FilledImage. 


This fgure illustrates Image' and FilledImage '. 





0riginal image, containing d single 'FilledImage'， 
region 


imfeature 





'ConvexHu11 ' -- p-by-2 matrix; the smallest convex polygon that can contain 
the region. 也 ach row ofthe matrix contaings the x- and y-coordinates of one 
vertex of the polygon. 


'ConvexImage ' - Binary image (uint8); the convex hull, with all pixels within 
thehull filled in (i.e., set to on). (For pixels that the boundary ofthe hull passes 
through, imfeature uses the same logic as roipoly to determine whether the 
pixel is inside or outside the hull.) The image is the Size ofthe bounding box of 
the region. 


'ConvexArea ' -- Scalar; the number of pixels in 'ConvexImage '. 


'EulLlerNumber ' -SScalar; equal to thenumber ofobjects in the region minus the 
number of holes in those objects. 


'Extrema' -- 8-by-2 matrix; the extremal points in the region. 也 ach row of the 
matrix contains the x- and y-coordinates of one ofthe points; the format ofthe 
vector lj8 [top-left top-right right-top right-bottom bottom-right 
bottom-left Left-bottom left-top|]. 


This figure illustrates the extrema oftwo different regions. In the region on the 
left, each extremal point is distinct; in the region on the right, certain extremal 
points (e.g., top-left and Left-top) are identical. 


top-|e 秆 








iop-riglt fop-|ef top-riglt 





|eft-top righf-iop |eff-fop right-top 


|eft-bottom right-bottom |eft-bottom right-bottom 


bottom-lef bottom-riglt bottom-lef bottom-right 


'EquivDiameter ' -SScalar; the diameter of a circle with the same area as the 
region. Computed as sqrt(4*Area/pi). 


'Solidity' -SScalar; the proportion of the pixels in the convex hull that are 
also in the region. Computed as Area/ConvexArea. 


'Extent ' -- Scalar; the proportion of the pixels in the bounding box that are 
also in the region. Computed as the Area divided by area ofthe bounding box. 
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Class Suppor 


Remarks 
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'PixelList' - p-by-2 matrix; the actual pixels in the region. 也 ach row of the 
matrix contains the x- and y-coordinates of one pixel in the region. 


The input label matrix L can be of class double or of any integer class. 


The comma-separated list syntax for structure arTrays is very useful when 
working with the output of imfeature.or exzample, for a field that contaings a 
scalar, you can use athis syntax to create a vector containing the value ofthigs 
field for each region in the image. 


For instance, istats is a structure array with field Area, then these two 
exXpressiongs are equivalent 


Stats(1).Area，Sstats(2).Area，...，Sstats(end).Area 
and 


Stats.Area 


Therefore, you can use these cajlls to create a vector containing the area of each 
region in the image. 


Stats = imfeature(L，Area ) | 
allArea = [stats.Areal]; 


allArea is a vector of the same length as the structure arTray StatsS. 


The function ismember is useful in conjunction with imfeature for selecting 
regions based on certain criteria.For example,these commands create a binary 
image containing only the regiongs in text,tif whose area is greater than 80. 


Idx = find([stats.Area]l > 80) ; 
BW2 = Ismember(L, Idx) ; 


Most ofthe measurements take very little time to compute. The exceptions are 
these, which maytake significantly longer, depending on thenumber ofregionsgs 
in L: 

ee ConvexHu11- 

ee ConvexImage 

e ConvexArea， 

ee FillJedImage， 


imfeafure 





Note that computing certain groups of measurements takes about the same 
amount oftime as computing just one of them, because imfeature takes 
advantage ofintermediate computations used in both computations. Therefore， 
it is fastest to compute all of the desired measurements in a single call to 
imfeature. 


Example BW = imread('text.tif') ; 
L = bwlabel(BW) ; 
Stats = imfeature(L，all ) 
Stats(23) 


ans = 


Area: 89 
Centroid: [95.6742 192.9775] 
BoundingBox: [87.5000 184.5000 16 15] 
MajorAxisLength: 19.9127 
MinorAxisLength: 14.2953 
Eccentricity: 0.6961 
orientation: 9.0845 
ConvexHu11: [13x2 double] 
ConvexImage: [15x16 1ogical ] 
ConveXxArea: 205 
Image: [15x16 1ogical ] 
FilledImage: [15x16 1ogical ] 
FiIl11edArea: 122 
EULerNumber: 0 
Extrema: [ 8x2 doublej] 
EquivDiameter: 10.6451 
Solidity: 0.4341 
EXxtent: 0.3708 
PiXxelList: [89x2 double] 


See Also bwlabe1l 
ismember in the MATLAB Function Reference 
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PurPpose 


Syntax 


Descripfion 


Intferacfive Use 


Specifying 
Connectivity 
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Fill image regiongs 


BW2 = imfil1(BW) 

[BW2 ,LOCATIONS] = imfil1l(BW) 
BW2 = imfil1(BW,LOCATIONS) 

BW2 = imfil1(BW,LOCATIONS ,CONN) 
BW2 = imfil1(BW,'holes') 

BW2 = imfil1(BW,CONN,'holes') 
I2 = imfil1l(I,'holes') 

I2 = imfil1(I,CONN,'holes') 


BW2 = imfil1(BW,LOCATIONS) performs a flood-fill operation on background 
pixels of the input binary image BW, starting 他 om the points specified in 
LOCATIONS. LOCATIONS can be a P-by-1l vector, in which case it contaings the 
linear indices ofthe starting locations. LOCATIONS can also beapP-by-ndims (BW) 
matrix, in which case each row contaings the array indices ofone ofthe starting 
locations. 


BW2 = imfil1(BW,'holes') Ells holes in the inputbinary image.Aholeis aset 
of background pixels that cannot be reached byfilling in the background from 
the edge ofthe image. 


I2 = imfil1(I，holes')fllsholesin aninputintensity image, I. In this case， 
ahole is an area of dark pixels surrounded by lighter pixels. 


BW2 = imfil1(BW) displays the binary image, BW, on the Screen and lets you 
Select the starting locations using the mouse. Click the mouse button to add 
points. Press <BackSpace> or <Delete> to remove the previously selected point. 
Ashift-click,right-click, or double-click selects afinal point and then starts the 
各 ]] operation; pressing <Return> finishes the selection without adding a point. 
Interactive use is Supported only for 2-D imasges. 


The syntax [BW2 ,LOCATIONS] = imfil1l(BW) can be used to get the starting 
points selected using the mouse. The output LOCATIONS is a vector of lnear 
indices into the input image， 


By default, imfi11 uses 4-connected background neighbors for 2-D inputs and 
6-connected background neighbors for 3-D inputs. For higher dimensions the 


imnfill 





Class Suppor 


Examples 


default background connectivity is determined by using 
conndef (NUM_DIMS ，'minimal ). 


You can overTride the default connectivity with these syntaxesgs: 


BW2 = imfil1l(BW,LOCATIONS ,CONN) 
BW2 = imfill(BW,CONN，holes ') 
I2 = imnfil1l(I,CONN，holes ') 


To override the default connectivity and interactively specify the starting 
locations, use this syntax: 


BW2 = imfiL1(BW,0,CONN) 


CONN may have any of the following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by-.… -by-3 matrix of 0's and 1's.The 1-valued elements define 
Deighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


The input image can be numeric or logical, and it must be real and nonsparse. 
It can have any dimension. The output image has the same class as the input 


image, 


Fill in the background of a binary imasge 位 om a specified starting location: 
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Algorithm 
See Also 


Reference 
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BW1 = [ 


口 口 口 一 口 口 一 口 
口 口 口 一 口 口 一 口 
怕 口 一 一 口 口 一 口 
人 
一 口 口 一 一 口 口 口 
0 
口 口 口 一 口 口 口 口 


] 
BW2 = imfill(BW1,[3 3],8) 


Fill in the holes of a binary imasge: 


BW4 = ~im2bw(imread( blood1.tif ' ) ) 
BW5 = limfill(BW4，holes ' ) 
imshow(BW4) ，figure，imshow(BW5) 


Fill in the holes of an intensity image: 
I = imread(' enamel.tif' ); 
I2 = imcomplement(imfil1l(imncomplement(I) ，holes ' ) ) 
imshow(I)，figure，imshow(I2) 

imfill uses an algorithm based on morphological reconstruction [JI]. 


bwselect, imreconstruct,， roif1iI11 


[了 Pierre Soille, MorpAolosical 11aase APpalysis: Primciples aq Applicatioms， 
Springer-Verlag, 1999, pp. 173-174. 


imfilter 





Purpose 


Syntax 


Descripfion 


Multidimensional image filtering 


B = imfilter(A,H) 
B ImfIlter(A,H,option1,option2，..,.) 


B = imfilter(A;,H) flters the multidimensional array A with the 
multidimensional flter H. The array, A，can be anonsparse numeric arTray of 
any class and dimension. The result, B, has the same size and class as A. 


卫 ach element ofthe output, B, is computed using double-precision floating 
point. IfAis an integer array, then output elements that exceed the range of 
the integer type are truncated, and fractional values are rounded. 


B = imfilter(A;,H,option1,option2,...) performs multidimensional 
filtering according to the specified options. Option arguments can have the 
following values. 








Boundary Options 
Opiion Description 
X Input array values outside the bounds ofthe array are 


implicitly assumed to have the value X. When no 
boundary option is specified, imfilter uses X = 0. 


'Symmetric， Input array values outside the bounds ofthe array are 
computed by mirror-reflecting the array across the arTray 
border. 

"FeplLicate' Input array values outside the bounds of the array are 


assumed to equal the nearest array border value. 


"circular' Input array values outside the bounds ofthe array are 
computed by implicitly assuming the input array is 
periodic. 
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Output Size Opiions 








Opiion Descripfion 

“Same， The output arTray is the same size as the input arTray. Thigs 
is the default behavior when no output size optiongs are 
specified. 

'fu11， The output arTray is the full filtered result, and so is 


larger than the input arTray, 





Correlation and Convolution Options 





Opiion Descripfion 





"Corr'， imfilter performs multidimensional filtering using 
correlation, which is the same way that filter2 performs 
和 ltering. When no correlation or convolution option ig 
specified, imfilter uses correlation. 


'Conv， imfilter performs multidimensional fltering using 
convVolution. 





N-D convolution is related to N-D correlation byareflection ofthe filter matrix. 


Examples This example starts by reading an image of a bouquet offlowers into a 
three-dimensional array of uint8 values, called rgb. The imshow function 
displays the original image, entitled 'Original '. 

rgb = imread(' flowers.tif ); 
imshow(rgb)，title(' Ooriginal ') 


Create a filter, h, that can be used to approximate linear camera motion. Use 
imfilter on the three-dimensional RGB image, rgb, to create a new image， 
rgb2. 


h = fspecial( ' motion' ，50，45) ; 
rgb2 = imfilter(rgb，h) ; 
figure，imshow(rgb2)，tit1le(' Filtered ') 
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See Also 


Note that imfilter is more memory ef8cient than some other filtering 
operations in thatit outputs an array ofthe same data type as the input image 
array. In this example, the output is an array of uint8. 


whos rgb2 
Name Size Bytes Class 
rgb2 362Xx500Xx3 543000  Uint8 array 


Filter the image once more, this time specifying the replicate boundary 
option and observe that the picture now extends to the border. 


rgb3 = imfilter(rgb，h， ' replicate ') ; 
figure，imshow(rgb3)，tit1le('` Filtered with boundary replication ) 


conv2, convn, filter2 
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Purpose Information about graphics file 


imfinfo is a MATLAB function. To get help for this function, select MATLAB 
Help 人 om the Help menu and view the online function reference pages. 
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Purpose 


Synftax 


Descripfion 


Class Suppor 


Example 


Display a histogram of image data 


Imhist(I,n) 
Imhist(Xx,map) 
[counts,Xx] = imhist(...) 


imhist(I,n) displays ahistogram with n bings for the intengsity image I above 
a grayscale colorbar of length n. Ifyou omit the argument,， imhist uses a 
default value ofn = 256ifiIis a grayscale image,orn=2ifiIisabinary image. 


imhist(X,map) displays a histogram for the indexed image X. This histogram 
showsgs the distribution ofpixel values above acolorbar ofthe colormap map. The 
colormap must be at least as long as the largest index in X. The histogram has 
one bin for each entry in the colormap. 


[counts,x] = imhist(...) returns the histogram counts in counts and the 
bin locationgs in x so that stem(x,counts) shows the histogram. For indexed 
images, it returns the histogram counts for each colormap entry; the length of 
counts is the same as the length of the colormap. 





Note For intensity images, the n bins ofthe histogram are each half-open 
intervals of width AZ( -1). In particular the pth bin is the half-open 
interval 


Ap-15)Mm-DD<xz<A4AD-05)[2 -1T) 
The scale factor 4 depends on the image class. 4A is 1 ifthe intensity image is 


double; A is 255 这 the intensity image is uint8; and A is 65535 这 the 
intensity Image is Uint16. 





The input image can be of class logical, uint8, uint16, or doub1le. 


II = imnread(' pout.tif ' ) ; 
Imhist(I) 
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See Also 
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5000 上 
4000 上 
3000 上 
2000 上 


1000 上 


histeq 
hist is in the MATLAB Function Reference 
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imhmax 





Purpose 
Syntax 


Descripfion 


Class Suppor 


再-maxima transform 


I2 = imhmax(I,h) 


I2 = imhmax(I,h) Suppresses all maxima in the intensity image, I, whose 
height is less than h, where h is a scalar. 


Regional maxima are connected components of pixels with the same intensity 
value, 如 whose external boundary pixels all have a value less than t. 


By default, imhmax uses 8-connected neighborhoods for 2-D images, and 
26-connected neighborhoods for 3-D images. For higher dimensions，imhmax 
Uses conndef (ndims(I) ，maximal ' ). 


I2 = imhmax(I,h,CONN) computes the 再 -maxima transform,， where CONN 
specifies the connectivity. CONN may have any of the following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of 0's and 1's.The 1-valued elements define 
Deighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element.， 


I can be of any nonsparse numeric class and any dimension. I2 has the same 
size and class as I. 
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Example 


See Also 


Reference 
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a = zeros(10,10) ; 

a(2:4;2:4) = 3; 55 maxima 3 higher than Surround 
a(6:8;,6:8) = 8; 55 maxima 8 higher than Surround 

b = imhmax(a,4); 5 only the maxima higher than 4 Survive， 


conndef,，imhmin，imreconstruct 


[1 Pierre Soille, MorpAolosical 11aase APpalysis: Principles aq Applicatioms， 
Springer-Verlag, 1999, pp. 170-1711. 
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Purpose 
Syntax 


Descripfion 


Class Suppor 


再 -minima trangsform 


I2 = imhmin(I,h) 


I2 = imhmin(I,h) Suppresses all minima in the intensity image, I, whose 
depth is less than h, where h is a scalar. 


Regional minima are connected components of pixels with the same intensity 
value, 如 whose external boundary pixels all have a value greater than 夺 


By default, imhmin uses 8-connected neighborhoods for 2-D images, and 
26-connected neighborphoods for 3-D images. For higher dimensions,， imhmin 
Uses conndef (ndims(I) ，maximal ' ). 


I2 = imhmin(I,h,CONN) computes the 再 -minima transform，where CONN 
specifies the connectivity. CONN may have any of the following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of 0's and 1's.The 1-valued elements define 
Deighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element.， 


I can be of any nonsparse numeric class and any dimension. I2 has the same 
size and class as I. 
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Example a = 10x*ones(10,10); 
a(2:4;2:4) = 7; 点 maxima 3 Lower than Surround 
al(6:8,6:8) = 2; 上 55 maxima 8 Lower than Surround 
b = imhmin(a,4); % only the minima 1Lower than 4 Survive . 
See Also conndef, imhmax，imreconstruct 
Reference [1 Pierre Soille, MorpAolosical 11aase APpalysis: Primczples aq Applicatioms， 


Springer-Verlag, 1999, pp. 170-1711. 
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@@ @@ @@ 
mimPosemn 
Purpose Impose minima 
Syntax I2 = imimposemin(I,BW) 
Descripfion I2 = imimposemin(I,BW) modifties the intensity image I using morphological 


reconstruction So it only has regional minima wherever BW is nonzero. BW is a 
binary image the same Size as I. 


By default, imimposemin uses 8-connected neighborhoods for 2-D images and 
26-connected neighborhoods for 3-D images. For higher dimensions， 
Imimposemin uses conndef(ndims(I) ，mimimum' ) . 


I2 = imimposemin(I,H,CONN) specifies the connectivity, where CONN may have 
any ofthe following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may also be defined in a more general way for any dimension by 
using for CONN a 3-by-3-by-…-by-3 matrix of 0s and 1S. The 1-valued elements 
define neighborhood locationgs relative to the center element of CONN. Note that 
CONN must be symmetric about its center element. 


Class Supporf I can be of any nonsparse numeric class and any dimension. BW must be a 


Donsparse numeric array with the same Size as I. I2 has the same Size and 
class as I. 
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Example Modify the image in bonemarr.tif so that is only has regional minima at one 
location. 


1 First read in and display the image to be processed, called the mask imasge. 


I= imread('bonemarr.tif' ) ; 
Imshow(I) 





2 _ Create the marker image that will be used to process the mask image. The 
example creates abinary image the same size as the mask image,flled with 
zeros. It then sets a small area of the binary image to 1; these pixels define 
the location of the minima in the mask image，. 
bw = zeros(Size(I) ) ; 
bw(98:102,101:105) = 1; 


To show where these pixels of interest fall on the original image, this code 
Superimposes the marker over the mask. The small white square marks the 
spot. This code is not essential to the imnpose minima operation . 

J = 工 ; 

J(bw -~= 0) = 255; 

figure，imshow(J) 
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3 Impose the minina on the input image by performing morphological 
reconstruction ofthe mask image with the marker image. Note how all the 
dark areas of the original image, except those marked, are lighter. 

K = imimposemin(I,bw); 
figure，imshow(K) 





To illustrate hovw this operation removes all minima in the original image 
except the imnposed minima, the example uses imregionalmin to find all 
regional minima in the image， 

bw2 = imregionalmin(K) ; 

figure，imshow(bw2) 
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Algorithm imimposemin uses a technique based on morphological reconstruction . 


See Also conndef,， imreconstruct,，imregionalmin 
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Purpose 


Synftax 


Descripfion 


Example 


Compute linear combination of images 


Z = imnlincomb(K1,A1,K2,A2,...,，Kn,An) 

Z = imnlincomb(K1,A1,K2,A2,...，kKn,An,K) 

Z = imnlincomb(...，output class ) 

Z = imnlincomb(K1,A1,K2,A2,...,，Kn,An) computes: 
K1*A1 + K2*A2 + ... + KnxAn 


where K1, K2, through Kn are real, double scalars and A1, A2, through An are 
real, nonsparse, numeric arTrays with the same class and size. Z has the same 
class and Size as A1. 


Z = imlincomb(K1,A1,K2,A2,...,，Kn,An;K) computes: 
K1*A1 + K2*A2 + ... + KnxAn + K 


where imlincomb adds K, areal, double scalar, to the sum ofthe products of K1 
through Kn and A1 through An. 


Z= imlincomb(...;,output class) lets you specify the class of Z. 
output_class is a string containing the name of a numeric class. 





Nofte When performing a series of arithmetic operations on apair of images， 
you can achieve more accurate results if you use imlLincomb to combine the 
operations, rather than nesting calls to the indqividual arithmetic fanctions， 
Such as imadd. When you nest calls to the arithmetic functions, and the input 
arraysgs are of an integer class, each fanction truncates and rounds the result 
before passing it to the next function, thus losing accuracy in the final result. 
imlincomb computes each element of the output, Z, individually in 
double-precision, floating point. If zis an integer array imLincomb truncates 
elements of Zz that exceed the range ofthe integer type, and rounds of 在 

位 actional values. 





Scale an image by a factor of two. 


I imread(' cameraman.tif ' ) ; 
J = imlincomb(2,I) ; 
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Imshow(JU ) 
Form a difference image with the zero value shifted to 128. 


I= imread('cameraman.tif ' ); 

J = Uint8(filter2(fspecial('gaussian' )， 工 ) ); 

K = imlincomb(1,I,-1,J,128); 5 Krc) = IOrc) - Jrc) + 128 
imshow(K) 


To illustrate how imlincomb performs all the arithmetic operations before 
truncating the result, compare the results of calculating the average of two 
arrays, X and Y, using nested arithmetic fanctions and then using imlincomb. 


Consider the values in row 1l, column 1: 255 in the X and 50 in Y. In the version 
that uses nested arithmetic functions, imadd adds 255 and 50 and truncates the 
result to 255 before passing itto imdivide. The average returned in Z(1,1) is 


128. 
X = Uint8([ 255 10 75; 44 225 100]) ; 
Y = Uint8([ 50 20 50; 50 50 50 ]); 
z -= imdivide(imadd(X,Y) ,2) 
又 - 荆 


128 15 63 
47 128 75 


imLincomb performs the addition and division in double precision and only 
truncates the final result. The average returned in Z2(1,1) is 153. 
Z2 = imlincomb(.5,X,，.5,Y) 
Z2 = 
153 15 63 
47 138 75 


Form a difference image with the zero value shifted to 128. 


I = imread(' cameraman.tif ' ) ; 
J = Uint8(filter2(fspecial('gaussian )， 工 ) ) ; 
K = imlincomb(1,I,-1,J,128) |; 
%5 KGrc) = IIrc) - J(rc) + 128 
imshow(K) 
See Also Imadd,， imcomp1lement,， imdivide，immultiply， imsubtract 
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Purpose 


Syntax 


Descripfion 


Remarks 


Class Suppor 


Example 


See Also 


Make a movie of amultiframe indexed image 


mmiOV 
mmiOV 


immovie(Xx,map) 
immovie(RGB) 


mov = immovie(X,map) returns the movie structure array, mov, from the 
images in the multiframe indexed image X with the colormap map. As it creates 
the movie array, it displays the movie 位 ames on the screen. You can play the 
movie using the MATLAB movie function. For details about the movie 
Structure arTray, see the reference page for getframe. 


X comprises multiple indexed images, allhaving the same size and all using the 
colormap map. X is an m-by-n-by-1l-by-k array, where k is the number of images. 


mov = immovie(RGB) returns the movie structure array mov from the images in 
the multiframe, truecolor image RGB. 


RGB comprises multiple truecolor images, all having the same size. RGB is an 


m-by-n-by-3-by-k array, where k is the number of images， 


You can also use the MATLAB function avifile to make movies fom images, 
The avifile function createsAVIfiles. In addition, you can convert an existing 
MATLAB movie into an AVIfile by using the movie2avi fanction,， 


An indexed image can be uint8, uint16, double, or 1ogical.Atruecolor image 
can be uint8, uint16, or doup1le. mov is a MATLAB movie Structure. 


1oad mri 
mov = Immovie(D,map) ; 


movie(mov 3) 


avifile, getframe, montage, movie, movIe2aviI 
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PurPpose 
Syntax 


Descripfion 


Example 


See also 
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Multiply two images, or multiply an image by a constant 
Z= imnmultiply(Xx,Y) 


Z= imnultiply(X,Y) multiplies each element in array X by the corresponding 
element in array Y andreturns the product in the corresponding element ofthe 
output arTray 2Z. 


IX andyY are real numeric arrays with the same size and class, then Zhas the 
same size and class as X. IX is a numeric array and Y is a scalar double, then 
Z has the same Size and class as X. 


I 节 Xis logical and Y is numeric, then Z has the same Size and class as Y. If X is 
numeric and Y is logical, then Z has the same Size and class as X. 


immultip1y computes each element of z individually in double-precision 
foating point. 开 X is an integer array, then elements of Z exceeding the range 
of the integer type are truncated, and fractional values are rounded. 


IX and Y are double arrays, you can use the expression X.*Y instead of this 
foanction,， 


Multiply an image by itself. Note how the example converts the class of the 
image from uint8 to uint16 before performing the multiplication to avoid 
truncating the results. 


I= imread('moon.tif ' ); 

I16 = Uint16(I) ; 

J = imnultiply(I16,I16) ; 
imshow(I)，figure，imshow(Jy) 


Scale an image by a constant factor: 


I= imread('moon.tif ' ); 
J = imnultiply(I,0.5) ; 
Subplot(1,2,1)，imshow(I) 
Subplot(1,2,2)，imshow(y ) 


imabsdiff,，imadd， imcomplement, imdivide，imlincomb，imsubtract 


Imnoise 





Purpose Add noise to an image 
Syntax J = imnoise(I,type) 
J = imnoise(I,type,parameters ) 


Descripfion J = imnoise(I,type) adds noise of given type to the intensity image I. type 
is a string that can have one ofthese values: 


'gaussian' for Gaussian white noise 


' Localvar' for zero-mean Gaussian white noise with an 
intensity-dependent variance 


ee 'poisson' for Poisson noise 
e 'Ssalt & pepper' for “on and off” pixels 
e 'speckle' for multiplicative noise 


J = imnoise(I,type,parameters) accepts an algorithm type plus additional 
modifying parameters particular to the type of algorithm chosen. 开 you omit 
these arguments, imnoise uses default values for the parameters. Here are 
examples of the different noise types and their parameters: 


eJ= imnoise(I，gaussian',m,v) addqds Gaussian white noise ofmean mand 
variance v to the image I. The default is zero mean noise with 0.01 variance. 


eJ= imnoise(I,，'1ocalvar',V) adds zero-mean, Gaussian white noise of 
local variance, V, to the image I.Vis an array ofthe same Size as I. 

eJ= imnoise(I，1localvar',image_intensity,var) adds zero-mean， 
Gaussian noise to an image I, where the local variance ofthe noise, var, is a 
fanction ofthe image intengsity values in I. The image_intensity and var 
arguments are vectors of the same size, and plot(image_intensity,Vvar) 
plots the functional releationship between noise variance and image 
intensity. The image_intensity vector must contain normalized intensity 
values ranging from 0 to |. 


J = imnoise(I,'poisson') generates Poisson noise fom the data instead 
ofadding artificial noise to the data. In order to respect Poisson statistics, the 
intensities of unit8 and uint16 images must correspond to the number of 
photons (or any other quanta of information). Double-precision images are 
used when the number of photons per pixel can be much larger than 65535 
(but less than 10^12); the intensities values vary between 0 and 1 and 
correspond to the number of photons divided by 10^12. 
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Class Suppor 


Example 


See Also 
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eJ=imnoise(I，salt & pepper',d) addssalt and pepper noise to theimasge 
TI, where d is the noise density. This affects approximately dx*prod(size(I)) 
pixels. The default is 0.05 noise density. 

eJ= imnoise(I，speckle',v) adds multiplicative noise to the image LI 
usingtheequation J = I+nx*I, where nis uniformly distributedrandom noise 
with mean 0 and variance v. The default for v is 0.04. 


I can be ofclass uint8, uint16, or double. The output image J is ofthe same 
class as I. II has more than two dimensions it is treated as a 
multidimensional intensity image and not as an RGB imasge. 


工 imread(' eight .tif ' ) ; 

JdJ = imnoise(I，Salt & pepper ,0.02) ; 
Imshow(I) 

figure，imshow(J) 





rand, randn in the MATLAB Function Reference 


imopen 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Open an image 


IM2 
IM2 


imopen(IM,SE ) 
imopen(IM,NHOOD ) 


IM2 = imopen(IM,SE) performs morphological opening on the grayscale or 


binary image IM with the structuring element SE. The argument SE must be a 


single structuring element object, as opposed to an array of objects. 


IM2 = imopen(IM,NHOOD) performs opening with the structuring element 
strel(NHO0D), where NHOOD is an array of 0's and ls that specifies the 
structuring element neighborhood. 


IM can be any numeric or logical class and any dimension, and must be 


Donsparse. If IM is logical, then SE must be flat. IM2 has the same class as IM. 


This example uses imopen to filter out the smaller objects in an image. 


1 Read the image into the MATLAB workspace and threshold 让 . 
II = imread(' nodules1.tif ' ) 
bw = ~iIim2bw(I,graythresh(I) ) ; 
imshow(bw)，title('Thresholded Image ') 





14-241 


imopen 





2 Create a disk-shaped structuring element and open the imasge. 
Se = Strel('disk' ,5) 
bw2 = imopen(bw,se) ; 
figure，imshow(bw2)，title(' After opening ) 





See Also Imclose, Imdilate, Imerode, strel 
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Purpose 


Syntax 


Descripfion 


Determine pixel color values 


P = impixel(I) 
= impIixel(X,map) 
P = impixel(RGB) 


局 


P = impixel(I;，cymr) 

P = impixel(X,map,cyr) 
P = impixel(RGB,c，r) 
[cr,P] = impixel(...) 


P = impixel(x,y,I,XxiyyI) 

P = impixel(x,y,X,map,Xxiyyi) 
P = impixel(Xx,y,， RGB,Xxi，yI) 
[xi,yi,P] = impixel(xy,...) 


impixelreturns the red, green, and blue color values ofspecified image pixels. 
In the syntaxes below, impixel displays the input image and waits for you to 
specify the pixels with the mouse. 


P = impixel(I) 
P impixel(X,map) 
P = impixel(RGB) 


H 节 you omit the input arguments, impixel operates on the image in the current 
aXeS. 


Usenormal button clicks to select pixels. Press Backspace or Delete to remove 
the previously selected pixel. A shift-click, right-click, or double-click adds a 
final pixel and ends the selection; pressing Return finishes the selection 
without adding a pixel. 


When you finish selecting pixels, impixel returns an m-by-3 matrix of RGB 
values in the supplied output argument. Ifyou do not sSupply an output 
argument, impixel returns the matrix in ans, 


You can also specify the pixels noninteractively, using these Syntaxes， 


P = impixel(I,cyr) 
P = impixel(X,map,cyr) 
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Class Suppor 


Remarks 


Example 
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rand c are equal-length vectors specifying the coordinates ofthe pixels whose 
RGB values are returned in P. The kth row ofP contains theRGB values forthe 
pixel (F(k),c(k) ). 


HIyou Supply three output arguments, impixel returns the coordinates of the 
Selected pixels. For example， 


[cr,P] = impixe1l(...) 


To specify a nondefault spatial coordinate System for the input image, use 
these Syntaxes. 


P = impixel(x,y,I,xiyyi) 
P = impixel(x,y,X,map,xiyyi) 
P = impixel(x,y,RGB,Xxiiyi) 


x and y are two-element vectors specifying the image XData and YData. xi and 
yi are equal-length vectors specifying the spatial coordinates ofthe pixels 
whose RGB values are returned in P. Ifyou supply three output arguments， 
impixel returns the coordinates ofthe selected pixels. 


[xi,yi,P] = impixel(x,y，...) 


The input image can be ofclass uint8, uint16, double, or 1ogical. All other 
inputs and outputs are of class doub1e. 


impixel works with indexed, intensity, and RGB imasges. impixel always 
returns pixel values as RGB triplets, regardless of the image type: 


e ForanRGB image, impixelreturns the actual data for the pixel. The values 
are either uint8 integers or double floating-point numbers, depending on 
the class ofthe image array. 


e For an indexed image, impixel returns the RGB triplet stored in the row of 
the colormap that the pixel value points to. The values are double 
foating-point numbers. 

e For an intensity imnage, impixel returns the intensity value as an RGB 
triplet, where R=G=B. The values are either uint8 integers or double 
foating-point numbers, depending on the class of the image array. 


RGB = imread(' flowers.tif ' ) ; 
C= [12 146 410]; 


impixel 





= [104 156 1291] ; 
pixels = impixel(RGB,cyr) 


pixels = 
61 59 “101 


253 240 0 
237 37 44 


See Also improfile, pixval 
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PurPpose 


Syntax 


Description 
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Compute pixel-value cross-sectiongs along line segments 


C = improfile 
C = improfile(n) 


C = improfile(I,Xxi,yi) 
C = improfile(I,Xi,yIyn) 


[cx,cy;c] = improfile(...) 
[cx,cy，Cc,Xxiyil = improfile(...) 


[...] = improfile(x,y,I,XiyyI) 
[...] = improfile(x;y,I,XiyyIyn) 


[...] = improfile(.. .method) 


improfile computes the intensity values alongalineoramultiline path in an 
image. improfile selects equally spaced points along the path you specify, and 
then uses interpolation to find the intensity value for each point. improfile 
works with grayscale intensity images and RGB images. 


Ifyou call improfile with one ofthese syntaxes, it operates interactively on 
the image in the current axes， 


C = improfile 
C= improfile(n) 


n specifies thenumber ofpoints to compute the intensity value for. Ifyou do not 
provide this argument, improfile chooses a value for n, roughly equal to the 
number of pixels the path traverses. 


Youspecify thelineorpath using the mouse, byclicking on points in the image. 
Press Backspace or Delete to remove the previously selected point. A 
shift-click, right-click, or double-click adds a final point and ends the selection; 
pressing Return finishes the selection without adding a point. When you finish 
selecting points, improfile returns the interpolated data values in c. c is an 
n-by-1vector ifthe input is a grayscale intensity imnage, or an n-by-1-by-3 array 
过 the input is an RGB image. 


improfile 





Class Suppor 


Ifyou omit the output argument, improfile displays a plot of the computed 
intensity values. Ifthe specified path consists of a single line segment， 
improfile creates a two-dimensional plot of intengsity values versus the 
distance along the line segment; 让 the path congsists oftwo or more line 
Segments, improfile creates a three-dimensional plot ofthe intensity values 
Versus their X- and y-coordinates. 


You can also specify the path noninteractively, using these Syntaxes. 


C = improfile(I,Xxi,yi) 
C = improfile(I,Xxi,yIyn) 


xi andyi are equal-length vectors specifying the spatial coordinates ofthe 
endpoints ofthe line segments. 


You can use these syntaxes to return additional information. 


[cx,cy;，c] = improfile(...) 
[cx,cy;，Cc,Xiyil = improfile(...) 


cx and cy are vectors of length n, containing the spatial coordinates ofthe 
points at which the intensity values are computed. 


To specify a nondefault spatial coordinate System for the input image, use 
these syntaxes. 


[...] = improfile(x,y,I,XI yiI) 
[...] = improfile(x,y,I,XiyyIyn) 


x and y are two-element vectors specifying the image XData and YData. 


[...] = improfile(...,method) usesthe specified interpolation method. 
method is a string that can have one ofthese values: 


e 'nearest' (default) uses nearest neighbor interpolation , 
ee 'bilinear' uses bilinear interpolation. 


ee 'bicubic' uses bicubic interpolation. 


Ifyou omit the method argument, improfile uses the default method of 
nearest '. 


Theinput image can be uint8, uint16, double,or 1ogical.All other inputs and 
outputs must be doub1le. 
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Example I = imread('alumgrns.tif') ; 
Xx = [35 338 346 1031] 
y = [253 250 17 148] ; 


improfile(I,x,y)，grid on 


250 
200 
150 


100 








See Also impixe1, pixval 
interp2 in the MATLAB Function Reference 
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Purpose Read image 他 om graphics file 


imread is a MATLAB fonction. To get help for this function, select MATLAB 
Help 人 fom the Help menu and view the online function reference page. 
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PurPpose 


Syntax 


Descripfion 
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Morphological reconstruction 


IM = imreconstruct (MARKER ,MASK ) 
IM = imreconstruct (MARKER ,MASK,CONN) 


IM = imreconstruct(MARKER,MASK) performs morphological reconstruction of 
the image MARKER under the image MASK. MARKER and MASK can be two intensity 
images or two binary images with the same Size. The returned image, IM is an 
intensity or binary image, respectively. MARKER must be the same Size as MASK， 
and its elements must be less than or equal to the corresponding elements of 

MASK. 


By default, imreconstruct uses 8-connected neighborhoods for 2-D images and 
26-connected neighborhoods for 3-D images. For higher dimensions， 
imreconstruct uses conndef (ndims(I) ，maximal ' ). 


IM = imreconstruct(MARKER,MASK,CONN) performs morphological 
reconstruction with the specified connectivity. CONN may have any of the 
following scalar values. 





Value Meaning 





Two-dimensional connectivifies 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by-.… -by-3 matrix of0's and 1s.The 1-valuedelements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


Imreconstruct 





Morphological reconstruction is the algorithmic basis for several other Image 
Processing Toolbox functions, including imclearborder, imextendedmax， 
imextendedmin, imfil11, Imhmax, imhmin, and imimposemin. 


Class SupPport  。 MARKER and MASK must be nonsparse numeric or logical arrays with the same 
class and any dimension. IM is ofthe same class as MARKER and MASK. 


Algorithm imreconstruct uses the “fast hybrid grayscale reconstruction”algorithm 
described in [1H]. 


See Also imclearborder，imextendedmax,，imextendedmin,， imfIl1，imhmax，imhmzIn， 
Imimposemin 
Reference [II Luc Vincent,“Morphological Grayscale Reconstruction in Image Analysis: 


Applications and Efficient Algorithms,”7 瓦 玉 玉 T7a7sactioms 0 7112aSe 
Processi1s, vol. 2, no. 2, April 1993, pp. 176-2011. 
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PurPpose 


Syntax 


Descripfion 
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Find regional maxima 


BW 
BW 


imregionalmax(I) 
imregionalmax(I,CONN) 


BW = imregionalmax(I) fnds the regional maxima ofI. imregionalmax 
returns a binary image, BW, the same size as I, that identifies the locations of 
the regional maxima in I. In BW, pixels that are set to 1 identify regional 
maxima; all other pixels are set to 0. 


Regional maxima are connected components of pixels with the same intensity 
value, 如 whose external boundary pixels all have a value less than 上 


By default, imregionalmax uses 8-connected neighborhoods for 2-D images and 
26-connected neighborhoods for 3-D images. For higher dimensions， 
imregionalmax uses conndef (ndims(I) ，maximal ). 


BW = imregionalmax(I,CONN) computes the regional maxima of I using the 
specified connectivity. CONN may have any of the following scalar values. 





Value Meaning 





Two-dimensional connecfivifies 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of0's and 1's. The 1-valued elements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


imregionalmax 





Class Suppor 


Example 


See Also 


I can be any nonsparse, numeric class and any dimension. BW is 1ogical. 


A=1 
A(2:4 
A(6:8,6: 
A(2,7) = 44 
A(3,8) = 45 
A(4,9) = 44 
久之 
10 10 
10 22 
10 22 
10 22 
10 10 
10 10 
10 10 
10 10 
10 10 
10 10 


regmax = Imregionalmax(A) 


本 一 


conndef,， imreconstruct,，imregionalmin 


口 口 口 口 口 口 一 一 一 口 


10 
22 
22 
22 
10 
10 
10 
10 
10 
10 


O*ones(10,10) 
2:4) = 22; 


口 口 口 口 口 口 一 一 一 口 


; 
5 maxima 12 higher than Surround 
5 maxima 23 higher than Surround 


10 
22 
22 
22 
10 
10 
10 
10 
10 
10 


口 口 口 口 口 口 一 一 一 口 


10 
10 
10 
10 
10 
10 
10 
10 
10 
10 


| 


10 
10 
10 
10 
10 
33 
33 
33 
10 
10 


口 口 一 一 一 口 口 口 口 口 


10 
44 
10 
10 
10 
33 
33 
33 
10 
10 


口 口 一 一 一 OOODDD 


10 
10 
45 
10 
10 
33 
33 
33 
10 
10 


口 口 一 一 一 口 口 一 口 口 


10 
10 
10 
44 
10 
10 
10 
10 
10 
10 


人 


10 
10 
10 
10 
10 
10 
10 
10 
10 
10 


0 
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Purpose 


Syntax 


Descripfion 


Class Suppor 
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Find regional minima 


BW imregionalmin(I) 
BW = imregionalmin(I,CONN) 


BW = imregionalmin(I) computes theregional minima ofI. The output binary 
image BWhas value 1 corresponding to the pixels of I that belong to regional 
minima and 0 otherwise. BW is the same Size as I. 


Regional minima are connected components of pixels with the same intensity 
value, 刀 whose external boundary pixels all have a value greater than 夺 . 


By default, imregionalmin uses 8-connected neighborhoods for 2-D images and 
26-connected neighborhoods for 3-D images. For higher dimensions， 
imregionalmin uses conndef (ndims(I) ，maximal ' ). 


BW = imregionalmin(I,CONN) specifies the desired connectivity. CONN may 
have any of the following scalar values. 





Value Meaning 





Two-dimensional connectivities 
4 4-connected neighborhood 
8 8-connected neighborphood 


Three-dimensional connecftivities 


6 6-connected neighborphood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of0's and 1's. The 1-valued elements define 
neighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


I can be any nonsparse, numeric class and any dimension. BW is 1ogical. 


imregionalmin 





Example A = 10*ones(10,10) ; 
A(2:4;2:4) = 3; minima 3 Lower than Surround 
A(6:8;,6:8) = 8; 点 minima 8 Lower than Surround 
和 
10 10 10 10 10 10 10 10 10 10 
10 7 7 7 10 10 10 10 10 10 
10 7 7 7 10 10 10 10 10 10 
10 7 素 7 10 10 10 10 10 10 
10 10 10 10 10 10 10 10 10 10 
10 10 10 10 10 2 2 2 10 10 
10 10 10 10 10 2 2 2 10 10 
10 10 10 10 10 2 2 2 10 10 
10 10 10 10 10 10 10 10 10 10 
10 10 10 10 10 10 10 10 10 10 
B = imregionalmin(A) 
B = 
0 0 0 0 0 0 0 0 0 0 
0 1 1 1 0 0 0 0 0 0 
0 1 1 1 0 0 0 0 0 0 
0 1 1 1 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 1 1 1 0 0 
0 0 0 0 0 1 1 1 0 0 
0 0 0 0 0 1 1 1 0 0 
0 0 0 0 0 0 0 0 0 0 
0 0 0 0 0 0 0 0 0 0 
See Also conndef, imreconstruct, imregionalmax 
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Imresize 





PurPpose 


Syntax 


Descripfion 
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Resize an image 


B = imresSsize(Ammethool) 
B = imresize(A,[mrows ncols],methool) 


B = imresize(...，methooain) 
B = imresize(...，methooah) 


imresize resizes an image of any type using the specified interpolation 
method. methnoo is a string that can have one ofthese values: 

e 'nearest' (default) uses nearest neighbor interpolation . 

e 'bilinear' uses bilinear interpolation. 

ee 'bicubic' uses bicubic interpolation . 


Ifyou omit the methoad argument, imresize uses the default method of 
nearest '. 


B = imresize(A,m,method) returns an image that is mtimes the size ofA. Ifnm 
is between 0 and1.0,Bis smallerthanA.Ifmis greaterthan 1.0,Bis largerthan 
A. 


B = imresize(A,[mrows ncols],method) returns an image of size 
[mrows ncols].Ifthe specified size does not produce the same aspect ratio 
as the input image has, the output image is qistorted. 


When the specified output size is smaller than the size ofthe input image, and 
method is 'bilinear' or 'bicubic', imresize applies a lowpass filter before 
interpolation to reduce aliasing. The default filter size is 11-by-11. 


You can specify a different order for the default filter using 
[...] = imresize(.. .1ethooin) 


n is an integer scalar specifying the size ofthe filter, which is n-by-n. Ifnis 0 
(zero), imresize omits the fltering step. 


You can also specify your own filter h using 


[...] = imnresize(...，1ethooih) 


Imresize 





h is any two-dimensional FIR filter (such as those returned by ftrans2, fwind1， 
fwind2, or fsamp2). 


Class Supporf The input image, A, can be numeric or logical and it must be nonsparse. The 
output image, B, is ofthe same class as the input imasge. 


See Also imrotate, imtransform, tformarray; interp2 in the MATLAB Function 
Reference 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 


Example 
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Rotate an image 


B 
B 


imrotate(A,angle,methnool) 
imrotate(A,angle,methoa，crop ') 


B = imrotate(A;,angle,method) rotates the imageAby angle degrees in a 
counter-clockwise direction, using the specified interpolation method. methoa 
is a string that can have one ofthese valuesgs: 


e 'nearest' (default) uses nearest neighbor interpolation . 
ee 'bilinear' uses bilinear interpolation , 


ee 'bicubic' uses bicubic interpolation 


Ifyou omit the methoad argument, imrotate uses the default method of 
nearest '. 


The returned image matrix B js, in general, larger than Ato include the whole 
rotated image. imrotate sets invalid values on the periphery of B to 0. 


B = imrotate(A,angle,methoq'crop') rotates the image Athrough angle 
degrees and returns the central portion which is the same size as A. 


The input image, A, can be numeric or logical and it must be nonsparse. The 
output image, B, is of the same class as the input imasge. 


To rotate the image clockwise, specify anegative angle. 


I = imread(' ic.tif' ); 

J = imrotate(I,-4，bilinear' ，crop ) 
imshow(I) 

figure，imshow(J) 


Imrofafe 








See Also imcrop, imresize, imtransform, tformarray 
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imshow 





PurPpose 


Syntax 


Descripfion 
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Display an image 


I,n) 

I,[lLow high]) 

BW) 

X,map) 

RGB ) 

...jidisplay_ option) 


Imshow 
Imshow 
Imshow 
Imshow 
Imshow 
Imshow 


et 


Imshow(Xx,y;，A,...) 
imshow filename 
h = imshow(...) 


imshow(I,n) displays the intensity imnage I with n discrete levels of gray. Iyou 
omait n, imshowuses 256 gray levels on 24-bit displays, or 64 gray levels on other 
Systems. 


imshow(I,[1L1ow high]) qisplays I as a grayscale intensity image, specifying 
the data range for I. The value low (and any value less than Low) displays as 
black, the value high (and any value greater than high) displays as white, and 
values in between display as intermediate shades of gray. imshow uses the 
default number of gray levels. Ifyou use an empty matrix ([])for [Low high]， 
imshow uses [min(I(:)) max(I(:))];theminimum value in I displays as 
black, and the maximum value displays as white. 


imshow(BW) displays the binary image BW. Values of 0 display as black, and 
values of 1 display as white. 


imshow(X,map) displays the indexed image X with the colormap map. 
imshow(RGB) displays the truecolor image RGB. 


imshow(...,display_option) displays the image, calling truesize 让 
display option js 'truesize', or Suppressing the call to truesize 下 
display_ option is 'notruesize'.Either option string can be abbreviated. If 
you do not supply this argument, imshow determines whether to call truesize 
based on the setting ofthe 'ImshowTruesize' preference. 


imshow(x,y,A, ...) uses the two-element vectors x and y to establish a 
nondefault spatial coordinate system, by specifying the image XData and 
YData. 


imshow 





Class Suppor 


Remarks 


See Also 


imshow filename displays the image stored in the graphics file filename. 
imshow calls imread to read the image 位 om the file, but the image data is not 
stored in the MATLAB workspace. The file must be in the current directory or 
on the MATLAB path. 


h = imshow(...) returns the handle to the image object created by imshow,. 


The input image can be ofclass 1ogical, uint8, uint16, or double, and it must 
be nonsparse. 


You can use the iptsetpref function to set Several toolbox preferences that 


modify the behavior of imshow. For example: 


ee 'ImshowBorder' controls whether imshow displays the image with a border 
around it. 


ee 'ImshowAxesVisib1e' controls whether imshow displays the image with the 
axes box and tick labels. 


ee 'ImshowTruesize' controls whether imshow calls the truesize fanction. 


Note thatthe display_option argumentto imshow enables you to overTride the 
'ImshowTruesize' preference. 


For more information about these preferences, see the reference entry for 
Iptsetpref. 


getimage, imread, Iptgetpref, Iptsetpref, Supbimage, truesize, Warp 


image, imagesc in the MATLAB Function Reference 
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PurPpose Subtract one image from another, or Subtract a constant 他 om an image 
Syntax Z = imsubtract(X,Y) 
Description Z = imsubtract(X,Y) Subtracts each element in array Y fom the 


corresponding element in array X and returns the difference in the 
corresponding element ofthe output array Z. X and Y are real, nonsparse 
numeric arrays of the same Size and class, or Y is a double scalar. The arTray 
returned, Z, has the same Size and class 3aS X. 


IXis an integer array, then elements of the output that exceed the range of 
the integer type are truncated, and fractional values are rounded. 


IfXxandyY are double arrays, then you can use the expression X-Yinstead ofthis 
fanction, 


Examples Subtract two uint8 arrays. Note that negative results are rounded to 0. 


X = Uint8([ 255 10 75; 44 225 100]) 
Y Uint8([ 50 50 50j 50 50 50 ]) 
Z= imnadd(X,Y) 
忆 


了 stimate and subtract the background ofthe rice image: 


I= imread(' rice.tif ' ); 

blocks = blkproc(I,[32 32]，min(x(:)) ); 

background = imresize(blocks,[256 256]，bilinear ) ; 
IP = imsubtract(I,background ) ; 

imshow(Ip,[]) 


Subtract a constant value from the rice image: 


I= imread('rice.tif ' ); 
Iq = imsubtract(I,50) ; 
Subplot(1,2,1)，imshow(I) 
Subplot(1,2,2)，imshow(Iq) 


See also imabsdiff,，imadd， imcomplLement，imdivide， imlincomb，immu1ltiply 
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imtophat 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Perform top-hat filtering 


IM2 = imtophat(IM,SE) 
IM2 = imtophat(IM,NHOOD ) 


IM2 = imtophat(IM,SE) performs morphological top-hat filtering on the 
grayscale or binary input image IMusing the structuring element SE, where SE 
is returned by strel1. SE must be a single structuring element object, not an 
array containing multiple structuring element objects. 


IM2 = imtophat(IM,NHO0OD), where NHOOD is an array of 0's and ls that 
specifies the size and shape ofthe structuring element, is the same as 
imptophat(IM,strel(NHOOD) ). 


IM can benumeric orlogical and mustbenonsparse. The output image, IM2, has 
the same class as the input image. Ifthe input is binary (logical), then the 
structuring element must be flat. 


You can use top-hat filtering to correct uneven illumination when the 
background is dark. This example uses top-hat filtering with a disk-shaped 
structuring element to remove the uneven background illumination from the 
Image rice .tif. 


1 Read the image into the MATLAB workspace. 
I= imread(' rice.tif ' ) ; 
Imshow(I)，title('original ) 
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2 Create the structuring element and perform top-hat filtering ofthe image. 
Se = Strel('disk' ,12) ; 
J = imtophat(I,Se); 
figure，imshow(J)，title('Step 1: Top-hat filtering ) 





3 Use imadjust and stretchlinm to make the result more easily visible. 
K = imadjust(J,stretchlim(J) ) ; 
figure，imshow(K)，title('Step 2: Contrast adjustment ' ) 





See Also imbothat, strel 
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Purpose 


Synftax 


Descripfion 


Apply 2-D spatial transformation to image 


B = imtransform(A,TFORM) 

B = imtransform(A,TFORM,INTERP) 

[B,XDATA,YDATA] = imtransform(...) 

[B,XDATA,YDATA] = imtransform(...,PARAM1,VAL1,PARAM2,VAL2，...) 


B = imtransform(A,TFORM) transforms the image A according to the 2-D 
spatial transformation defined by TFORM, which is a spatial transformation 
structure (TFORM) as returned by maketformor cp2tform. Ifndims(A) > 2, such 
as for an RGB image, then the same 2-D transformation is automatically 
applied to all 2-D planes along the higher dimensions. 


When you use this syntax, imtransform automatically shifts the origin ofyourT 
output image to make as much ofthe transformed image visible as possible. 工 
you are using imtransform to do image registration, this syntax is not likely to 
give you the results you expect; you may want to set 'XData' and 'YData， 
explicitly. For more information, see Parameters, as well as 了 xample 3. 


B= inmtransform(A,TFORM,INTERP) specifies the form ofinterpolation to use. 
INTERP can be one ofthe strings 'nearest'，'bilinear' ,or 'bicubic '. 
Alternatively, INTERP can be a RESAMPLER Structure as returned by 
makeresampler， This option allows more control over how resampling is 
performed. The default value for INTERP is 'bilinear '. 


[B,XDATA,YDATA] = imtransform(...) returns the location ofthe output 
imageBinthe outputX-Y space. XDATA and YDATA are two-element vectors. The 
elements of XDATA specify the x-coordinates of the first and last columns of B. 
The elements of YDATA specify the y-coordinates ofthe first and last rowsgs of B. 
Normally, imtransform computes XDATA and YDATA automatically so that 也 
contains the entire transformed image A. However, you can overTride this 
automatic computation; See below. 


[B,XDATA,YDATA] = imtransform(...,PARAM1,VAL1,PARAM2,VAL2,..,.) 
specifies parameters that control various aspects ofthe spatialtransformation 
Parameter names can be abbreviated, and case does not matter. 
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Paramefers 
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This table lists all the parameters you can specify. Note that parameter names 


can be abbreviated and are not case-Sensitive. 





Paramefter 


Descripfion 





'UData， 
"VData ， 


'XData 
'YData 


Both ofthese parameters are two-element real 
vectors.'UData' and 'VData' sSpecify the spatial 
location ofthe image Ain the 2-D input space， 
U-V， The two elements of 'UData ' give the 
-coordinates (horizontal) ofthe first and last 
columns of A, respectively.， The two elements of 
'VData' give the v-coordinates (vertical) ofthe 
first and last rows of A, respectively 

The default values for 'UData' and 'VData' are 
[1 size(A,2)] and [1 size(A,1)],respectively 


Both ofthese parameters are two-element real 
vectors.'XData' and 'YData' sSpecify the spatial 
location ofthe output imnage Bin the 2-D output 
Space X-Y，The two elements of 'XData' give the 
X-Coordinates (horizontal) of the first and last 
columns of B, respectively The two elements of 
'YData' give the y-coordinates (vertical) of the 
first and last rows of B, respectively. 


If 'XData' and 'YData' are not specified， 
imtransform estimates values for them that will 
completely contain the entire transformed output 
image. 





imftransform 








Parameter 


Description 





'XYScale， 


' Size， 


A one- or two-element real vector The first 
element of 'XYScale' specifies the width of each 
output pixel in X-Y space. The second element (让 
present) specifies the height ofeach output pixel. 
If 'XYScale' has only one element, then the same 
value is used for both width and height. 

If 'XYScale' is not specified but 'Size' is, then 
'XYScale' is computed from 'Size'，'XData '， 
and 'YData'. Ifneither 'XYScale' nor 'Size' is 
provided, then the scale ofthe input pixels is 
Used for 'XYScale '. 


Atwo-element vector ofnonnegative integers. 
'Size' specifies the number ofrows and columnmns 
ofthe output image B. For higher dimensions， 
the size of B is taken directly from the size of A. 
In other words, size(B,k) equals size(A,k) for 
k > 2. 开 'Size' is not specified, then it is 
computed from 'XData'，'YData' ,and 

'XYScale '. 
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Parameter Descripfion 





'Fil1Values' An array containing one or several fll values. 
Fill values are used for output pixels when the 
corresponding transformed location in the input 
image is completely outside the input image 
boundaries. IfAis 2-D,'Fillvalues' mustbe a 
scalar 再 owevemn 让 As dimension is greater than 
two, then 'FillVvalues' can be an array whose 
Size Satisfies the following constraint: 
size(fil1l values,k) must either equal 
Sl1ze(A,k+2) or 1. 

For example, 计 Alis a uint8 RGB image that is 
200-by-200-by-3, then possibilities for 
'Fi1l1Values' include: 


0 - 丘 ]] with black 
[0;0;0] - also 拉 ]] with black 
255 - 丘 ]] with white 
[255;255;255] - also fl] with white 
[0;0;255] -fl with blue 


[255;255;0] -fill with yellow 


HAis 4-D with size 200-by-200-by-3-by-10, then 
'Fil1Values' can be a scalar 1-by-10, 3-by-l1, or 
3-by-10. 





Notftes e When you do not specify the output-space location for B using 'XData' and 
'YData', imtransform estimates them automatically using the function 
findbounds. For some commonly-used transformations, Such as afGine or 
projective, for which a forward-mapping is easily computable, findbounds is 
fast. For transformationgs that do not have a forward mapping, such as the 
polynomial ones computed by cp2tform, findbounds can take Signifcantly 
longer. Ifyou can specify 'XData' and 'YData' dqirectly for such 
transformations, imtransform may run noticeably faster. 


e The automatic estimate of 'XData' and 'YData' using findbounds is not 
guaranteed in all cases to completely contain all the pixels of the 
transformed input imasge. 
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Class Suppor 


Example 


e The output values XDATA and YDATA may not exactly equal the input 'XData 
and 'YData' parameters. This can happen either because ofthe need for an 
integer number or rowgs and columns, or 让 you specify values for 'XData '， 
'YData'，'XYScale' ,and 'Size' that are not entirely consistent， In either 
case, the first element of XDATA and YDATA always equals the first element of 

'XData' and 'YData', respectively.， Only the second elements of XDATA and 
YDATA might be different. 


e imtransform assumes spatial-coordinate conventions forthetransformation 
TFORM. Specifically, the first dimension of the transformation is the 
horizontal or x-coordinate, and the second dimension is the vertical or 
y-coordinate，Note that this is the reverse of the array Subscripting 
convention in MATLAB. 


e TFORM must be a 2-D transformation to be used with imtransform. 上 or 
arbitrary-dimensional array transformations, see tformarray， 


The input image, A, can be ofany nonsparse numeric class, real or complex, or 
it can be ofclass 1ogical. The class of B is the same as the class of A. 


Example 1 
Apply a horizontal shear to an intensity image. 


I= imnread( cameraman.tif ' ) ; 

tform = maketform( ' affine' ,，[100; .5 1.0;001]); 
J= imtransform(I,tform) ; 
Imshow(I)，Tfigure，ijimshow(JU ) 


Example 2 

A projective transformation can map a square to a quadrilateral. In thigs 
example, set up an input coordinate system so that the input image fills the 
unit square and then transform the image into the quadrilateral with vertices 
(0 0),(10),(11), (0 1l)tothe quadrilateral with vertices (-42),(-8 3), (-3 -5), and 
(6 3). Fill with gray and use bicubic interpolation. Make the output size the 
same as the input size. 


I= imnread( cameraman.tif ' ) ; 

udata = [0 1]; vdata = [01]; 上 5 input coordinate System 

tform = maketform( projective'，[00;) 1 0j 1 1; 01],，... 
[-4 2; -8 -3j -3 -5j 6 3]); 
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[B,xdata,ydata] = 
imtransform(I,tform，'bicubic ，udata' ,udata,.. . 
"vdata ,vdata,... 
'SIZe' ,Size(I)，... 
fi11 128) ; 
Subplot(1,2,1)，imshow(udata,vdata,I)，axis on 
Subplot(1,2,2)，imshow(xdata,ydata,B)，axis on 


Example 3 
Register an aerial photo to an orthophoto. 


unregistered = imread('westconcordaerial.png ) 
figure，imshow(unregistered ) 
figure，imshow('westconcordorthophoto.png ) 
1oad westconcordpoints 上 51oad Some points that were already picked 
t_concord = cp2tform(input_points,base_points，projective ) 
info = imfinfo( westconcordorthophoto.png ) ; 
registered = imtransform(unregisteredt_ concord，.. . 

'XData' ,[1 info.Width]， 'YData ,[1 info.Height]) ; 
figure，imshow(registered ) 


See Also cp2tform, imresize,， imrotate, maketform, makeresampler, tformarray 
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Purpose Write image to graphics 玫 le 


imwrite is a function in MATLAB. To get help for this function， select 
MATLAB Help from the Help menu and view the online fanction reference 
page. 
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Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


Algorithm 


See Also 
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Convert an indexed image to an intensity image 


I = ind2gray(X,map) 
I = ind2gray(X,map) converts the image X with colormap map to an intensity 
image I. ind2gray removes the hue and saturation information 位 om the input 


image while retaining the luminance. 


X can be ofclass uint8, uint16, or double. I is of class doub1le. 


1oad trees 

I = ind2gray(X,map) ; 
Imshow(X,map) 
figure, imshow(I) 





ind2gray converts the colormap to NTSC coordinates using rgb2ntsc, and sets 
the hue and saturation components (Tand CO) to zero, creating a gray colormap， 
ind2gray then replaces the indices in the image X with the corresponding 
grayscale intensity values in the gray colormap. 


gray2ind, imshow, rgb2ntsc 


ind2rgb 





Purpose 
Syntax 


Descripfion 


Class Suppor 


See Also 


Convert an indexed image to an RGB image 
RGB = ind2rgb(X,map) 


RGB = ind2rgb(X,map) converts the matrix X and corresponding colormap map 
to RGB (truecolor) format. 


X can be ofclass uint8, uint16, or doub1le. RGB is an m-by-n-by-3 array of class 
doub1e. 


ind2gray, rgb2ind 
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PurPpose 
Syntax 


Descripfion 


Example 


See Also 
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Get Image Processing Toolbox preference 
value = 1Iptgetpref(prefname) 


value = iptgetpref(prefname) returns the value ofthe Image Processing 
Toolbox preference specified by the string prefname. For Preferences for a 
complete list of valid preference names. Preference names are not 
case-Sensitive and can be abbreviated. 


iptgetpref without an input argument qisplays the current setting of all 
Image Processing Toolbox preferences. 


value = iptgetpref( ImshowAxesVisibJle ') 
Value = 
off 


Imshow, IptSsetpref 


ipfsetpref 





Purpose Set Image Processing Toolbox preferences or display valid values 
Syntax iptsetpref(prefname ,value) 
Descripfion iptsetpref(prefname) displaysthevalid values for prefname. See Preferences 


for a complete list of available preferences. 


iptsetpref(prefname,value) sets the Image Processing Toolbox preference 


specified by the string prefname to value. The setting persists until the end of 


the current MATLAB session, or until you change the setting. (To make the 


value persist between sessions, put the command in your startup .mfile.) 


Preferences This table describes the available preferences. Note thatthe preference names 
are case insensitive and can be abbreviated. 





Preference Name 


Values 


Description 





"ImshowBorder” 


"ImSshowAXxeSVisib1e， 


'1oose' (default) 


Or ' 熙 lght， 


"On ' oOF 
'off' (default) 


If 'ImshowBorder' is '1oose', imshow displays 
the image with a bordqer between the image and 
the edges ofthe figure window, thus leaving 
room for axegs labels, titles, etc. 开 
'ImshowBorder' is 'tight',，imshow adqjusts the 
和 gure size so that the image entirely fills the 

和 gure. 

Note: There may still be a border 计 the image is 
Very Small, or 让 there are other objects besides 
the image and its axes in the 和 gure. 


If 'ImshowAxesVisible' is 'on'，imshow 
displays the image with the axes box and tick 
labels. If ' ImshowAxesVisible' is 'off '， 
imshow displays the image without the axes box 
and tick labels. 
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Preference Name 


Values 


Descripfion 





"ImshowTruesize， 


TruesIizeWarning 


Example 


See Also 
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'auto' (default) or 
manual 


'on' (default) or 
Off 


If 'ImshowTruesize' is 'manual'，imshow dqoes 
not call truesize. If 'ImshowTruesize' is 
'auto',， imshow automatically decides whether 
to call truesize. (imshow calls truesize 这 there 
will be no other objects in the resulting figure 
besides the image and its axes.) You can 
overTride this setting for an individual display by 
specifying the display_option argument to 
imshow or you can call truesize manually after 
displaying the image. 


If 'TruesizeWarning' is 'on' ,the truesize 
function displays a warning 这 the image is too 
large to fit on the screen. (The entire image is 
still displayed, but at less than true size.) 工 
'TruesizeWarning' is 'off' ,truesize doesnot 
display the warning. 

Note: This preference applies even when you 
call truesize indirectly such as through 
Imshow 


iptsetpref(' ImshowBorder ，tight ) 


Imshow, Iptgetpref, truesSIze 


axis in the MATLAB Function Reference 
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Purpose Compute inverse Radon transform 
Synftax I = iradon(P,thetal) 
I= iradon(P,thetayzIznterp,fIIter,din) 


[I,hl] = iradon(...) 


Descripftion I = iradon(P,theta) reconstructs the image I 位 om projection data in the 
two-dimensional array P. The columns of P are parallel beam projection data. 
iradon assumes thatthe center ofrotation is the center point ofthe projections， 
which is dqefined as ceil(size(P,1)/2). 


theta describes the angles (in degrees) at which the projections were taken. 世 
can be either a vector containing the angles or a scalar specifying D_theta, the 
incremental angle between projections. If theta is a vector, it must contain 
angles with equal spacing between them. Iftheta is a scalar specifying 
D_theta, the projections are taken at angles theta = mx*D_ theta, where 
m=0,1,2,...,Size(P,2) 1. Ithe input is the empty matrix ([]),D_ theta 
defaults to 180/size(P,2). 


iradon uses the filtered back-projection algorithm to perform the inverse 
Radon transform. The filter is designed directly in the frequency domain and 
then multiplied bythe FFT ofthe projections. The projections are zero-padded 
to apower of 2 before filtering to prevent spatial domain aliasing and to speed 
up the FFT. 


I = iradon(P,theta,znterp,fiIter,d,n) specifies parameters to use in the 
inverse Radon transform. You can specify any combination ofthe last four 
arguments. iradon uses default values for any of these arguments that you 
omait. 


Interp specifies the type of interpolation to use in the backprojection. The 
available options are listed in order of increasing accuracy and computational 
complexity: 

e 'nearest' -nearest neighbor interpolation 

ee '1linear' -jlinear interpolation (default) 

e 'Spline' -spline interpolation 


fi7Iter specifies the filter to use for 位 equency domain filtering. fiIter is a 
string that specifies any ofthe following standard filters: 
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Class Suppor 


Example 


14-278 


ee 'Ram-Lak' -The cropped Ram-Lak or ramp filter (default). The frequency 
response of this filter is | f |. Because this filter is sengsitive to noise in the 
projections, one of the filters listed below may be preferable. These filters 
multiply the Ram-Lak filter by a windovw that de-emphasizes high 
位 equencies. 

e 'Shepp-Logan' -The Shepp-Logan filter multiplies the Ram-Lak filter by a 
Sinc function. 

e 'Cosine' -The cosine filter multiplies the Ram-Lak filter by a cosine 
fanction. 

e 'Hamming' -The Hamming filter multiplies the Ram-Lak filter by a 
再 amming window， 

e 'Hann' -The Hann filter multiplies the Ram-Lak filter by a Hann window. 


disascalarin therange (0,1] that modifies the filter byrescaling its frequency 
axis. The default is 1. Id is less than 1, the filter is compressed to fit into the 
位 equencyrange [0,dj, in normalized frequencies; all frequencies above d are set 
to 0. 


nis ascalarthat specifies the number ofrowsgs and columns in the reconstructed 
image. Ifnis not specified, the size is determined 他 om the length ofthe 
projections. 


n = 2x*floor(Size(P,1)/(2*sdqrt(2))) 


Ifyou specify n, iradon reconstructs a Smaller or larger portion of the image， 
but does not change the scaling ofthe data. Ifthe projections were calculated 
with the radon fanction, the reconstructed image may not be the same Size as 
the original image， 


[I,h] = iradon(...) returns the frequency response ofthe filter in the vector 
h 


All input arguments and output arguments must be of class double， 


P = phantom(128 ) ; 

R = radon(P,0:179) 

I = iradon(R,0:179，nearest ' ，Hann ) ; 
imshow(P) 

figure，imshow(I) 


iradon 








Algorithm iradon uses the filtered backprojection algorithm to perform the inverse 了 Radon 
transform. The filter is designed directly in the frequency domain and then 
multiplied by the FFT ofthe projections. The projections are zero-padded to a 
power of 2 before filtering to prevent spatial domain aliasing and to speed up 


the FFT. 
See Also radon, phantonm 
References [II Kak, Avinash C., and Malcolm Slaney, Przmzciples of ComzpzterIzeQ 


7o7zosrapjpzc 112aSI1S. New York: IE 了 了 Press. 
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PurPpose Return true for a binary image 
Syntax flag = isbw(A) 
Description flag = isbw(A) returns 1 证 Ais a binary image and 0 otherwise. 


The input image,A, is consideredto beabinary imageifit is anonsparse logical 
arTay. 


Class Support The input image, A, can be any MATLAB array. 


See Also isind, isgray, isrgb 


14-280 


isflat 





Purpose 
Syntax 


Descripfion 


Class Suppor 


See Also 


Return true for flat structuring element 


TF = isflat(SE) 


TF = isflat(SE) returns true (1) 放 the structuring element SE is flat; 


otherwise it returns false (0). If SE is an array of STREL objects, then TF is the 


Same SlZze as SE. 
SE is a STREL object. TF is a double precision value. 


Strel 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


See Also 
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Return true for intengsity image 
flag = Isgray(A) 


flag = isgray(A) returns 1iAis a grayscale intengsity image and 0 otherwise. 


isgray uses these criteria to decide 二 Ais an intengsity image: 


e IfAis ofclass double, all values must be in the range [0,1], and the number 
of dimnensions of A must be 2. 


e IfAis ofclass uint16 or uint8, the number of dimensions ofA must be 2. 





Nofte Atfour-dimensional array that contains multiple intensity images 
returns 0, not 工 . 





The input image, A, can be ofclass logical, uint8, uint16, or doub1e. 


isbw, 1Ssind, Isrgb 


isindqd 





Purpose 
Syntax 


Descripfion 


Class Suppor 


See Also 


Return true for an indexed image 
flag = isind(A) 


flag = isind(A) returns 1 过 Ais an indexed image and 0 otherwise. 


isind uses these criteria to determine 计 Ais an indexed image: 


e IfAis ofclass double, all values in Amust be integers greater than or equal 


to 1 and the number of dimensions of A must be 2. 


e IfAis ofclass uint8 or uint16, the number ofdqimensions of A must be 2. 





Nofte Atfour-dimensional array that contains multiple indexed images 
returns 0, not 工 . 





Acan be ofclass 1ogical, uint8, uint16, or doub1e. 


isbw, Isgray, Isrgb 
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PurPpose 
Syntax 


Descripfion 


Class Suppor 


See Also 
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Return true for an RGB imasge 
flag = isrgb(A) 


flag = isrgb(A) returns 1 这 Ais an RGB truecolor image and 0 otherwise， 


isrgb uses these criteria to determine 放 Ais an RGB imasge: 


e IfAis ofclass double, all values must be in the range [0,1, and A must be 
m-by-n-by-3. 


e IfAis ofclass uint16 or uint8, Amust be m-by-n-by-3. 





Note Atfour-dimensional array that contains multiple RGB images returns 0， 
not 工 . 





Acan be ofclass 1ogical, uint8, uint16, or doub1e. 


Isbw, isgray, Isind 


label2rgb 





Purpose 


Synftax 


Descripfion 


Convert a label matrix into an RGB image 


RGB = label2rgb(L) 

RGB = label2rgb(L,map) 

RGB = label2rgb(L,map,zerocolor) 

RGB = label2rgb(L,map,zerocolororder) 


RGB = label2rgb(L) converts a label matrix L, Such as those returned by 
bwlabel or watershed, into an RGB color image for the purpose of visualizing 
the labeled regions. The label2rgb fonction determines the color to assign to 
each object based on the number of objects in the label matrix and range of 
colors in the colormap. The label2rgb function picks colors fom the entire 
range. 


RGB = label2rgb(L,map) defines the colormap to be used in the RGB imasge. 
The colormap, map, can have any of the following values: 


e 1-by-3 colormap matrix 


e String containing the name ofaMATLAB colormap function, such as 'jet' 
or 'gray' (See colormap for a list of supported colormaps.) 


e Function handle of a colormap function, such as Qjet or agray 
Ifyou do not specify map, the default value is 'colorcube '. 


RGB = label2rgb(L,map,zerocolor) defines the RGB color of the elements 
labeled zero (ie., the background) in the input label matrixL. As the value of 
zerocolor, specify an RGB triple or one of the strings listed in this table. 








Value Color 

'b， blue 

22 Cyam 

9 green 

'K black 

'm， magenta 
机 red 
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Class Suppor 


Example 


See Also 
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Value Color 
WwW' white 
Y， yellow 





H 开 you do not specify zerocolor, the default value for zero-labeled elements is 
[1 1 1] Cwhite). 


RGB = label2rgb(L,map,zerocolor,order) controls how label2rgb assigns 
colormap colors to regions in the label matrix. Iforder is 'noshuffle' (the 
default), labe12rgb assigngs colormap colors to label matrix regiongs in 
numerical order. Iforder is 'shuffle',， label2rgb assigns colormap colors 
pseudo-randomjly. 


The input label matrix L can have any nonsparse, numeric class. It must 
contain fnite,nonnegative integers. The output of label2rgbis of class uint8. 


I = imread(' Price.tif ' ); 
figure，imshow(I)，title( original image ) 

BW = im2bw(I，graythresh(I) ) ; 

L = bwlabel(BW) ; 

RGB = Jabel2rgb(L) ; 

RGB2 = Jabel2rgb(L， spring ，"'c" ， "shuffle ) ; 
imshow(RGB)，Tfigure，imshow(RGB2 ) 





bwJlabel, bwlabeln, Ismember, watershed 


makeluft+ 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Construct a lookup table for use with app1lLy1lLut 


1Lut = makelut(fun,n) 
lut = makelut(fun,n,P1,P2,...) 


lut = makelut(fun,n) returns a lookup table for use with applLylLut. fun is 
either a string containing the name of a function or an inline function object. 
The function should take a 2-by-2 or 3-by-3 matrix of 1s and 0's as input and 
return ascalar.nis either2or 3,indicating the size oftheinputto fun.makelLut 
creates Lut by passing all possible 2-by-2 or 3-by-3 neighborhoods to fun, one 
at a time, and constructing either a 16-element vector (for 2-by-2 
neighborhoods) or a 512-element vector (for 3-by-3 neighborhoods). The vector 
consists ofthe output fom fun for each possible neighborhood. 


lut = makelut(fun,n,P1,P2,...) passes the additional parameters 
P1,P2,...，toTfun. 


1Lut is returned as a vector of class doub1e. 


In this example, the function returns 1 (true) 这 the number of ls in the 
neighborhood is 2 or greater, and returns 0 (false) otherwise. makelut then usesgs 
the function to construct a lookup table for 2-by-2 neighborhoods. 


f= inline(' Sum(x(:)) >= 2 ); 
1Lut = makelut(f,2) 


Lut = 


人 
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See Also 
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二 志和 


applLyLlLut 


makeresampler 





Purpose 
Syntax 


Descripfion 


Create resampling structure 


R = makeresampler(Interpozantpadmethool) 


R = makeresampler(interpoTantpadmethod) creates a separable resampler 
structure for use with tformarray and imtransform. 


The interpolant argument specifies the interpolating kernel that the 
separable resampler uses. In its Simplest form, interpolant can have any of 
the following strings as a value. 








Interpolant Descripiion 

"cubic' Cubic interpolation 

'1Linear' Linear interpolation 

nearest Nearest neighbor interpolation 





Iyou are using a custom interpolating kernel, you can specify interpolant as 
a cell array in either of these forms 


{fhalf_width，positive_half} half_width is a positive scalar designating 
the half width of a symmetric interpolating 
kernel. positive_half is a vector ofvalues 
regularly sampling the kernel on the closed 
interval [0 positive_half] 


{fhalf_width，interp_fcn} interp_fcn is a function handle that 
returns interpolating kernel values, given 
an array of input values in the interval 
[0 positive_half] 


To specify the interpolation method independently along each dimension, you 
can combine both types of interpolant specifications. The number of elements 
in the cell array mustequal thenumber oftransform dimensions. For exzample， 
过 you specify this value for interpolant 


{ nearest ' ， '1Linear ，{2 KERNEL_TABLE}} 
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the resampler uses nearest-neighbor interpolation along the first transform 
dmension, linear interpolation along the second dimension, and a custom 
table-based interpolation along the third. 


The padmethoad argument controls how the resampler interpolates or assigns 
values to output elements that map close to or outside the edge of input array. 
The following table lists all the possible values of paamethnod. 





Pad NMethod 


Descripiion 





bound 


Circular， 


' 千 IJ 


'Pep1Licate 


'“Symmetric 


Assigngs values fom the fll value array to points that 
map outside the array and repeats border elements of 
array for points that map inside the array. (Same asgS 
'replicate'.) When interpolant ij8 'nearest' ,this 
pad method produces the same results as 'fil1 '. 
'bound' is like 'fil1', but avoids mixing 下 1]] values 
and input image values. 


Pads array with circular repetition of elements within 
the dimension. Same as padarray. 


Generates an output array with smooth-looking edges 
(except when using nearest neighbor interpolation). 
For output points that map near the edge ofthe input 
arTray (either inside or outside), it combines input 
image andfill values. When interpolant is 'nearest '， 
this pad method produces the same results as 'bound '. 


Pads array by repeating border elements of array、. 
Same as padarray. 


Pads array with mirror reflections of itself. Same as 
padarray. 





In the case of 'fil1'，'replicate'，'circular' ,or 'Symmetric' ,the 
resampling performed by tformarray or imtransform occurs in two logical 


StepgS: 


1 Pad the array Ainfinitely to fl] the entire input transform space 
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2 了 valuate the convolution ofthe padded A with the resampling kernel at the 
output points specified by the geometric map 


卫 ach nontransform dimension is handqled separately. The paddqing is virtual， 
(accomplished by remapping array subscripts) for performance and memory 
e 什 ciency. 开 you implement a custom resampler, you can implement these 
behaviors. 








Custom The syntaxes described above construct a resampler Structure that uses the 
Resamplers separable resampler function that ships with the Image Processing Toolbox. 攻 
is also possible to create a resampler structure that uses a user-wWTitten 
resampler by using this syntax 
R = makeresampler(PropertyName ,PropertyValue,...) 
The makeresampler fanction Supports the following properties. 
Property Descripfion 
Type Can have the values 'separable' or 'custom' andmust always be supplied. 
If 'Type' is 'separable' ,the only other properties that can be specified are 
'Interpolant' and 'PadMethod' ,and the result is equivalent to using the 
makeresampler(interpolantpadmethodq) Syntax. If 'Type' is 'custom '， 
youmust specify the'NDims' and 'ResampleFcn' properties and, optionally， 
the 'CustomData' property. 
'PadMethod See the padmethod argument for more information, 
'Interpolant' See the interpolant argument for more information. 
'NDims' 'NDims' is a positive integer and indicates what dimensionality the custom 


resampler can handle. Use a value of Inf to indicate that the custom 
resampler can handle any dimension. If 'Type' is 'custom', NDims jg 
required. 
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Property 


Descripfion 





ResampleFcn' 


CustomData.， 


This property is a handle to a function that performs the resampling. The 
fonction is called with the following interface. 


B = resample fcn(A,M,TDIMS_A,TDIMS_B,FSIZE_A,FSIZE_B,F,R) 


See the help for tformarray for information about the inputs A, TDIMS_A， 
TDIMS_B, and F The argument Mis an array that maps the transform 
Subscript space of B to the transform subscript space ofA. IAhasN 
transform dimensions (N=Llength(TDIMS_A) ) andB has P transform 
dimensions (P=length(TDIMS_ B)),then ndims(M)=P+1,ifN>1 andP 这 N==1， 
and size(M,P+1)=N. 


The first P dimensions of M correspond to the output transform space， 
permuted according to the order in which the output transform dimensions 
are listed in TDIMS_B. (In general TDIMS_A and TDIMS_B need not be Sorted in 
ascending ordem although such a limitation may be imposed by specific 
resamplers.) Thus, the first Pelements of size(M) determine the sizes ofthe 
transform dimensions of B. The input transform coordinates to which each 
point is mapped are arrayed across the final dimension of M, following the 
order given in TDIMS_A. Mmust be double. FSIZE_A and FSIZE_B are the fu]l 
sizes ofA and B, padded with 1 as necessary to be consistent with TDIMS_A， 
TDIMS_B, and size(A). 


User-defined. 





Example 


See Also 
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Stretch an image in they-direction using separable resampler that applies in 
cubic interpolation in the y-direction andnearest neighbor interpolation in the 
X-direction. (This is equivalent to, but faster than, applying bicubic 
interpolation.) 


A= imread(' moon.tif ' ) ; 

resamp = makeresampler({' nearest ， cubic' +，fil1 ) 
Stretch = maketform( ' affine' ，[1 0; 0 1.3; 00]) 

B = imtransform(A,stretch,resamp) ; 


Imtransform, tformarray 


maketform 





Purpose 
Syntax 


Descripfion 


Transform 
Types 


Create geometric transformation Structure 


T = maketform(transfomntype...) 


T = maketform(transformtype,...) creates amultidimensional spatial 
transformation Structure (called a TFORM struct) that can be used with the 
tformfwd，tforminv, flLiptform, imtransform, or tformarray fanctions. 


transformtype can be any ofthe following spatial transformation types. 
maketform Supports a Special syntax for each transformation type. See the 
following sections for information about these Syntaxes. 








Transform Type Descripfion 

'affine， Affine transformation in 2-D or N-D 
'projective' Projective transformation in 2-D or N-D 

"Custom' User-defined transformation, may be N-D to M-D 
'box' Independent affine transformation (scale and 


Shi 化 ) in each dimension 


'Composite'， Composition of an arbitrary number of more basic 
transformations 





Affine 


T = maketform( 'affine',A) buildqs a TFORM struct, T, for an N-dimensional 
affine transformation. Ais a nonsingular real (N+1)-by-(N+1) or (N+1)-by-N 
matrix. IfAis (N+1l)-by-(N+l), the last column ofA must be [zeros(N,1);1]. 
Otherwise, Ais augmented automatically, such that its last column is 
[zeros(N,1);1].The matrix A defines a forward transformation Such that 
tformfwd(U,T)，where U is a 1-by-N vector, returns a 1-by-N vector X，Such 
that X=Ux*A(1:N,1:N)+A(N+1,1:N).Thasboth forward and inverse 
transformations. 


T = maketform( 'affine',U,X) buildqs a TFORM struct, T, for a two-dimensional 
affine transformation that maps each row of U to the corresponding row of X. 
The U and Xx arguments are each 3-by-2 and define the corners of input and 
output triangles. The corners may not be collinear. 
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Proiecfive 

T = maketform('projective',A) builds aTFORM struct for an N-dimensional 
projective transformation. Ais a nonsingular real (N+Jl)-by-(N+1) matrix. 
A(N+1,N+1) cannot be 0. The matrix A defines a forward transformation Such 
thattformfwd(U,T),where Uis a 1-by-N vector, returns a 1-by-N vector X, Such 
thatX = WI1:N)/W(N+1), where W=[U 1]*A.The transformation Structure, T， 
has both forward and inverse transformations. 


T = maketform('projective',U,X) builqs a TFORM struct, T, for a 
two-dimensional projective transformation that maps each rovw of Uto the 
Corresponding row of X. The U and X arguments are each 4-by-2 and define the 
corners of input and output quadrilaterals. No three corners may be collinear、. 


Custom 
T = maketform( custom',，NDIMS_IN,NDIMS_OUT，.. . 

FORWARD_FCN ,INVERSE_FCN ,TDATA) buildqs a custom TFORM 
struct, T, based on user-provided function handles and parameters. NDIMS_IN 
and NDIMS_0OUT are the numbers ofinput and output dimensions. FORWARD_FCN 
and INVERSE_FCN are function handles to forward and inverse functions. Those 
fanctions must Support the Syntaxesgs: 


Forward function:  X = FORWARD_FCN(U,T) 
Inverse function U = INVERSE_FCN(X,T) 


where U is a P-by-NDIMS_IN matrix whose rowsgs are points in the 
transformation's input space, and Xis a P-by-NDIMS_0UT matrix whose rowsgs are 
points in the transformation's output space. The TDATA argument can be any 
MATLAB array and is typically used to store parameters of the custom 
transformation. It is accessible to FORWARD_FCN and INVERSE_FCN via the 
“tdata” field ofT. Either FORWARD_FCN or INVERSE_FCN can be empty, although 
at least INVERSE_FCN must be defined to useT with tformarray or 
imtransform. 


Box 

T = maketform( box' ,tsize;，LOW,HIGH) or 

T = maketform('box' ,INBOUNDS，0OUTBOUNDS) buildqs an N-dqimensional affine 
TFORM struct, T. The tsize argument is an N-element vector of positive 
integers. LOW and HIGH are also N-element vectors. The transformation maps 


maketform 





Example 


See Also 


an input box defined by the opposite corners ones(1;,N) and tsize or， 
alternatively, by corners INBOUNDS(1,:) and INBOUND(2,:) to an output box 
defined by the opposite corners LOW and HIGH or OUTBOUNDS(1, :) and 
OUTBOUNDS(2,:).LOW(K) and HIGH(K) must be different unless tsize(K) is |， 
in which case the affine scale factor along the 玉 -th dimension is assumed to be 
1.0. Similarly, INBOUNDS(1,K) and INBOUNDS(2,K) must be different unless 
OUTBOUNDS(1,K) and OUTBOUNDS(1,K) are the Same, and vice verSa. The 'box' 
TFORM is typically used to register the row and column subscripts of an image 
or array to some“worldq”coordinate System 


Composite 

T= maketform(' composite ' ,，T1,T2，...),，TL) OF 

T = maketform('composite'，[T1T2 ... TL])buildqs aTFORM struct,T, whose 
forward and inverse functions are the functional compositions of the forward 
and inverse fanctions ofthe T1，T2，...，TL. 


For example, 计 L = 3, then tformfwd(U,T) is the same as 
tformfwd(tformfwd(tformfwd(U,T3) ,T2) ,T1). The components T1 through 
TLmust be compatible in terms ofthenumbers ofinput and output dimensions， 
Thas a defined forward transform function only 计 all ofthe component 
transforms have defined forward transform functions.T has a defined inverse 
transform function only 计 all ofthe component functions have defined inverse 
transform functions. 


Make and apply an affine transformation. 


T = maketformn( affine' ，[.5 00;) .520;j001]); 
tformfwd([10 20],T) 

I= imnread(' cameraman.tif ' ) ; 

I2 = imtransform(I,T) ; 

Imshow(I2 ) 


tformfwd, tforminv, f1LiIptform， imtransform, tformarray 
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matf2gray 





Purpose 


Syntax 


Descriptiion 


Class Suppor 


Example 


See Also 
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Convert a matrix to a grayscale intensity image 


II = mat2gray(A,[amin amax]) 
工 mat2gray(A) 


I = mat2gray(A,[amin amax]) converts the matrix Ato the intensity image I. 
The returned matrix I contains values in the range 0 (black) to 1.0 (full 
intensity or white). amin and amax are the values in Athat correspond to 0 and 
1.0 in 工 . 


I = mat2gray(A) sets the values of amin and amax to the minimum and 
maximum values in A. 


The input array, A, and the output image, I, are of class doub1le. 


I= imread('rice.tif ' ); 

J = filter2(fspecial(' Sobel )，I) ; 
K = mat2gray(J) ; 

Imshow(I) 

figure，imshow(K) 





gray2ind 


mean 人 2 





Purpose 
Syntax 
Descripfion 


Class Suppor 


Algorithm 


See Also 


Compute the mean of the elements of a matrix 


B = mean2(A) 


B = mean2(A) computes the mean ofthe values in A. 


The input image, A, can be numeric or logical. The output image, B, is a scalar 
of class doub1le. 


mean2 computes the mean of an array Ausing mean(A(:) ). 


Std2 
mean, std in the MATLAB Function Reference 
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medfil+2 





PurPpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 
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Perform two-dimensional median filtering 


B = medfilt2(A,[mnl]) 
B medfilt2(A) 
B = medfilt2(A，indexed ，..,.) 


Median filtering is a nonlinear operation often used in image processing to 
reduce “salt and pepper”noise. Median filtering is more effective than 
convolution when the goal is to simultaneously reduce noise and preserve 
edges, 


B = medfilt2(A,[m n]) performs median filtering ofthe matrix Ain two 
dmensions. Each output pixel contains the median value in the m-by-n 
neighborhood around the corresponding pixel in the input image. medfilt2 
pads the image with zeros on the edges, so the median values for the points 
within [m n]/2 ofthe edges may appear distorted. 


B = medfilt2(A) performs median filtering ofthe matrix Ausing the default 
3-by-3 neighborhood. 


B = medfilt2(A, indexed',...) processes Aas an indexed image, padding 
with zeros 这 the class ofAis uint8, or ones 这 the class of Alis doub1e. 


The input image, A, can be ofclass logical, uint8, uint16, or doub1le (unless 
the 'indexed' syntax is used, in which case A cannot be of class uint16). The 
output image, B, is of the same class as A，. 


Ifthe input image Ais ofan integer class, all ofthe output values are returned 
as integers. Ifthe number ofpixels in the neighborhood (i.e., mx*n) is even, some 
of the median values may not be integers. In these cases, the fractional parts 
are discarded. Logical input is treated similarly、. 


For example, suppose you call medfilt2 using 2-by-2 neighborhoods, and the 
input imageis a uint8 array that includes this neighborhood. 


1 5 
4 8 


medfilt2returns an output value of4forthis neighborhood, although the true 
median is 4.5. 


medfil+2 





Example This example adds salt and pepper noise to an image, then restores the image 
using medfilt2. 


I= imnread(' eight.tif'); 

J = imnoise(I，Salt & pepper ;0.02) ; 
K = medfilt2(J) ; 

imshow(JU) 

figure，imshow(K) 





Algorithm medfilt2 uses ordfilt2 to perform the iltering. 
See Also filter2, ordfilt2, Wiener2 
Reference [Lim, Jae S. 7Tzo-Dimze7siozal Sis7al ad 112age Processi1s. Englewood 


Cliffs, NJ: Prentice Hall, 1990. pp. 469-476. 
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montage 





PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 
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Display multiple image frames as a rectangular montage 


montage(I) 
montage(BW) 
montage(X,map) 
montage(RGB ) 

hn = montage(...) 


montage displays all of the frames of a multiframe image array in a single 
image object, arranging the 人 fames so that they roughly form a square. 


montage(I) displays the k fames ofthe intensity image array I. I is 
m-by-n-by-1-by-k. 


montage(BW) displays the k 他 ames ofthe binary image array BW. BW is 
m-by-n-by-1-by-k. 


montage(X,map) displays the k fames ofthe indexed image array X, using the 
colormap map for all 位 ames. X is m-by-n-by-1-by-k. 


montage(RGB) displays the k fames of the truecolor image arTay RGB. RGB ig 
m-by-n-by-3-by-k. 


h = montage(...) returns thehandle tothe image object. 
The input image can be ofclass 1ogical, uint8, uint16, or doub1e. 


Load mri 
montage(D,map) 


montage 








Immovie 


See Also 
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nl 和 lter 





PurPpose 


Syntax 


Descripfion 


Class Suppor 
Remarks 


Example 


See Also 
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Perform general sliding-neighborhood operations 


B = nlfilter(A,[mnl,fun) 
nlJfilter(A,[m nl,fun,P1,P2,...,) 
B = nlfilter(A，indexed ，..,.) 


四 
中 


B = nlfilter(A,[m n]l,fun) applies the function fun to each m-by-n sliding 
block ofA. fun is a function that accepts an m-by-n matrix as input, and returns 
a scalar result. 


C = fun(x) 


c is the output value for the center pixel in the m-by-n block x. nLfilter calls 
fun for each pixel in A. nLfilter zero pads the m-by-n block at the edges, 让 
DecesSary. 


B = nlfilter(A,[m nl,fun,P1,P2,...) passesthe addqitional parameters 
P1,P2，,...，,to fun. 


B = nlfilter(A，indexed',...) processes Aas an indexed image,padding 
with ones 让 Alis ofclass double and zeros ifAlis ofclass uint8. 


The input image, A, can be ofany class sSupported by fun. The class ofB depends 
on the class ofthe output from fun. 


nlfilter can take a long time to process large images. In some cases, the 
colfilt fanction can perform the same operation much faster，. 


fun can be a function_handle, created using e. This example produces the 
same result as calling medfilt2 with a 3-by-3 neighborphood. 


B = nlfilter(A,[3 3],emyfun) ; 
where myfun is an M-file containing 


function Scalar = myfun(X) 
Scalar = median(x(:)); 


fan can also be an inline object. The example above can be written as 


fun = inline( ' median(x(:)) ); 


blkproc, coOLfilt 


normXxcorr2 





Purpose 
Syntax 


Descripfion 


Class Suppor 


Algorithm 


Example 


Normalized two-dimensional cross-correlation 
C = normxcorr2(TEMPLATE,A) 


C = normxcorr2(TEMPLATE,A) computes the normalized cross-correlation of 
the matrices TEMPLATE and A. The matrix A must be larger than the matrix 
TEMPLATE for the normalization to be meaningful. The values of TEMPLATE 
cannot all be the same. The resulting matrix, C，contains the correlation 
coefficients, which may range in value 位 om -1.0 to 1.0. 


The input matrices can be of class uint8, uint16, or doub1e. 


normxcorr2 uses the following general procedure: 

1 Calculate cross-corTrelation in the spatial or the 他 equency domain， 
depending on Size of images. 

2 Calculate local sums by precomputing running sums. [H] 


3 Use local sums to normalize the cross-correlation to get correlation 
coefficients. [2] 


T= .2*ones(11); 扣 5 make 1Light gray plus on dark gray background 
T(6,3:9) = .6; 

T(3:9,6) = .6; 

BW = T>0.5; smake White plus on black background 


imshow(BW) ，title(' Binary ') 
figure，imshow(T)，title( Template ') 


5 make new image that offsets tempJlate 工 

T_ offset = .2x*ones(21) ; 

offset = [3 5]; 5 Shift by 3 rows，5 columns 

T_offset( (1:Ssize(T,1))+offset(1)，(1:Ssize(T,2))+offset(2) ) =T; 
figure，imshow(T_offset)，title('Ooffset Template ') 


%5 Cross-correlate BW and T_offset to recover offset 
cc = normxcorr2(BW,T_ offset ) ; 

[max_cc，imax] = max(abs(cc(:))); 

[ypeak，Xxpeak] = ind2sub(Ssize(cc) ,imax(1) ); 

corr_ offset = [ (ypeak-Ssize(T,1)) (xpeak-Size(T,2)) ]; 
Isequal(corr_ offset,offset) 5 1 means offset Was recovered 
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normXxcorr2 





See Also corrcoef 


References [II J.P. Lewis, “Fast Normalized Cross-Correlation' , Industrial Light & Magic. 
<http://www.idiom,com/~-zilla/Papers/nvisionInterface/nip .htm1> 


[2] Robert M. Haralick and Linda G. Shapiro, Co7zpzter aa 民 opotl Vsio7m， 
Volume II, Addison-Wesley, 1992, pp. 316-317. 
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ntfsc2rgb 





Purpose 


Syntax 


Descripfion 


Class Suppor 


See Also 


Convert NTSC values to RGB color space 


rgbmap = ntsc2rgb(yidqmap) 
RGB = ntsc2rgb(YIQ) 


rgbmap = ntsc2rgb(yiqmap) converts the m-by-3 NTSC (television) color 
values in yiqmap toRGB color space. Ifyiqmap is m-by-3 and contains the NTSC 
luminance ( 蕊 and chrominance (and O) color components as columns, then 
rgbmap is an m-by-3 matrix that contains the red, green, and blue values 
equivalent to those colors. Both rgbmap and yiqmap contain intensities in the 
range 0 to 1.0. The intensity 0 corresponds to the absence ofthe component， 
while the intengsity 1.0 corresponds to fall saturation of the component. 


RGB = ntsc2rgb(YIQ) converts theNTSC imageYIQtothe equivalent truecolor 
Image RGB. 


ntsc2rgb computes the RGB values from the NTSC components using 


于 1.000 “0.956 “0.621|| 节 
G| = 11.000 -0.272 -0.647|17 
已 1.000 -1.106 1.703|jQ 


The input image or colormap must be of class double. The output is of class 
doub1e. 


rgb2ntsc, rgb2ind, ind2rgb, ind2gray 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 


See Also 
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Perform two-dimensional order-statistic 有 ltering 


中 
中 


ordfilt2(A;order ,domain) 
ordfilt2(A;order domain,S) 
B = ordfilt2(...,，padopt) 


四 
中 


B = ordfilt2(A,order,domain) replaces each element in A by the order-th 
element in the sorted set of neighbors specified by the nonzero elements in 
domain. 


B = ordfilt2(A,order,domain,S), where S is the same Size as domain, useSs 
the values of S corresponding to the nonzero values of domain as additive 
offsets. 


B = ordfilt2(...,padopt) controls how the matrix boundaries are padded. 
Set padopt to 'zeros' (the default), or 'symmetric'.Ifpadoptis 'zeros' ,Aigs 
padded with zeros at the boundaries. If padopt is 'symmetric', Ais 
sSymmetrically extended at the boundaries. 


The class ofA can be logical, uint8, uint16, or doub1e. The class ofB is the 
same as the class of A, unless the additive offset form of ordfilt2 is used, in 
which case the class of B is doub1e. 


domain is equivalent to the structuring element used for binary imasge 
operations. It is a matrix containing only 1”s and 0's; the ls define the 
neighborhood for the filtering operation. 


For example,B = ordfilt2(A,5,ones(3,3)) imnplements a 3-by-3 median 
filter; B = ordfilt2(A,1,ones(3,3)) implements a 3-by-3 minimum 磋 ]ter; 
andB=ordfilt2(A,9,ones(3,3)) imnplements a 3-by-3 maximum filter. 
B=ordfilt2(A,1,[010; 101;010])replaceseachelementinAbythe 
minimum of its north, east, south, and west neighbors. 


The syntax that includes S (the matrix of additive offsets) can be used to 
imnplement grayscale morphological operations, including grayscale dilation 
and erosion. 


medfilt2 


ordfil+2 





Reference [Haralick, Robert M., and Linda G. Shapiro. Comzpxter aa 尺 obpot Visio7， 
Volx7e 了 Addison-Wesley, 1992. 
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olf2psf 





PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 


See Also 
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Convert optical transfer function to point-spread function 


PSF = otf2psf(OTF) 
PSF = otf2psf(OTF,OUTSIZE) 


PSF = otf2psf(OTF) computes the inverse Fast Fourier Transform (IFFT) of 
the optical trangsfer function (OTF) array and creates a point-spread function 
(PSF), centered at the origin. By default, the PSF is the same Size as the OTF. 


PSF = otf2psf(OTF,0OUTSIZE) converts the OTF array into a PSF array, where 
OUTSIZE specifies the size ofthe output point-spread function. The size ofthe 
output array must not exceed the size of the OTKF array in any dimension . 


To center the PSF at the origin, otf2psf circularly shifts the values of the 
output array down (or to the right) until the (1,1) element reaches the central 
position, then it crops the result to match dimensions specified by OUTSIZE. 


Note that this function is used in image convolution/deconvolution when the 
operations involve the FFT. 


0OTF can be any nonsparse, numeric array. PSF is of class double. 


PSF = fspecial('gaussian' ,13，,1) ; 

OTF = psf2otf(PSF,[31 31]); % PSF --> OTF 

PSF2 = otf2psf(OTF,Size(PSF)); “0OTF --> PSF2 
Subplot(1,2,1); Surf(abs(OTF)); title('|OTF| ); 

axis Square;j axis tight 

Subplot(1,2,2); Surf(PSF2); title(' corresponding PSF ) ; 
axiSs Square;j axis tight 


psf2otf, Circshift, padarray 


Padarray 





Purpose Pad an array 
Syntax B = padarray(A,padsizemethod,dqirection) 
Descripfion B = padarray(A,padsize,method,direction) pads array A with padsize 


number of elements along each dimension, using specified method and 
direction. The N-th element ofthe padsize vector specifies the padding size for the 
N-th qimension ofthe array, A. 


method can be a numeric scalar, in which case it specifies the value for all 
padding elements, or one of the following strings which specify other methods 
used to determine pad values. By default, METHOD sets the pad value to the 0. 








Value Meaning 

"Circular' Pad with circular repetition of elements within the 
dimension . 

:Feplicate'， Pad by repeating border elements of array. 

'Symmetric， Pad array with mirror reflections of itself. 





direction specifies where to pad the array along each dimension. By default， 
direction ls 'post '. 








Value Meaning 

:pre' Pad before the first element of each qimension. 

'post' Pad after the last element of each qimension. This is the 
default. 

'both'' Pads before the first element and after the last element 


of each dimension. 





Class Support ”When padding with a constant value, A can be numeric or logical. When 
padding using the 'circular'，'replicate' ,or 'Ssymmetric' methods, Acan 
be of any class. B is ofthe same class as A. 
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Padarray 





Example 
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Add three elements of padding to the beginning of a vector. The padding 
elements contain mijrror copies of the array. 


b = padarray([1 2 34],3，Ssymmetric'` ，pre ') 
b 一 
3 2 1 1 2 3 4 


Add three elements ofpaddingtotheend ofthe first dimension ofthe array and 
two elements of padding to the end of the second dimension. Use the value of 
the last array element as the padding value. 


B = padarray([1 2; 3 4],[3 2]，replicate'，post ') 
B = 


momow 一 
人 上 上 上 上 户 
人 上 上 上 人 上 上 人 下 有 
人 上 上 上 户 


Add three elements ofpadding to each dimension of athree-dimensional array. 
卫 ach pad element contaings the value 0. 


A=[12;34]; 
B=[56;78]; 
C = cat(3,A,B) 
C(:， :1) = 


1 2 
3 4 

5 2) = 
5 6 
7 8 


D = padarray(C,[3 3];,0，both ) 


Padarray 





Circshift，imf1ilter 


See Also 
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Phantom 





PurPpose 


Syntax 


Descripfion 
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Generate a head phantom image 


P = phantom(oaern) 
P = phantom(E,n) 
[P,E] = phantom(...) 


P = phantom(oaef,n) generates an image ofa head phantom that can be used 
to test the numerical accuracy of radon and iradon or other two-dimensional 
reconstruction algorithms. P is a grayscale intengsity image that consists ofone 
large ellipse (representing the brain) containing several smaller ellipses 
(representing features in the brain). 


defis astringthat specifies thetype ofhead phantom to generate. Valid values 
are: 


e 'Shepp-Logan' -atest image used widely by researchers in tomography. 


e 'Modified Shepp-Logan' (default) -avariant ofthe Shepp-Logan phantom 
in which the contrast is improved for better visual perception. 


nis ascalarthat specifies the number ofrowsgs and columns in P. 开 you omit the 
argument, n defaults to 256. 


P = phantom(E,n) generates a user-defined phantom, where each row of the 
matrix E specifies an ellipse in the image.Ehas six columns, with each column 
containing a different parameter for the ellipses. This table describes the 
columns of the matrix. 








Column Parametier Meaning 

Column 1 A Additive intensity value ofthe 
ellipse 

Column 2 a Length ofthe horizontal semi-axis of 


the ellipse 


Column 3 b Length ofthe vertical semi-axis of 
the ellipse 


Column 4 X0 X-coordinate of the center of the 
ellipse 





Phantom 





Class Suppor 


Remarks 


Example 








Column Parameter Meaning 

Column 5 y0 y-coordinate ofthe center ofthe 
ellipse 

Column 6 phi Angle (in degrees) between the 


horizontal semi-axis of the ellipse 
and the xX-axis ofthe image 





For purposes of generating the phantom, the domains for the x- and y-axegs 
span [-1,1]. Columns 2 through 5 must be specified in terms of this range. 


[P,E] = phantom(...) returns the matrix E used to generate the phantom. 
All inputs and all outputs must be of class doub1e. 


For any given pixel in the output image,the pixels value is equal to the sum of 
the additive intensity values of all ellipses that the pixel is a part of. Ia pixel 
is not part of any ellipse, its value is 0. 


The additive intensity value Afor an ellipse can be pogsitive or negative; 这 it is 
negative, the ellipse will be darker than the surrounding pixels. Note that， 
depending on the values of A, some pixels may have values outside the range 
[0, 了 车 . 


P = phantom( 'Modified Shepp-Logan ,200) ; 
imshow(P) 
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Phantom 








Reference [Jain, Anil 民 . Faamzeptals of DigSital 1agse Processi11S. Englewood Cliffs， 
NJ: Prentice Hall, 1989. p. 439. 


See Also radon, iradon 
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Pixval 





Purpose 


Synftax 


Purpose 


See Also 


Display information about image pixels 


pixval on 

pixval off 

pixVval 
pixval(fig,option) 


pixval on turngs on interactive display ofinformation about image pixels in the 
current figure. pixval installs a black bar at the bottom of the figure, which 
displays the (X,y) coordinates for whatever pixel the cursor is currently overT， 
and the color information for that pixel. Ifthe image is binary or intensity, the 
color information is a single intengsity value. Ithe image is indexed or RGB， 
the color information is an RGB triplet. The values displayed are the actual 
data values, regardless of the class of the image array, or whether the data is 
in normal image range. 


HI 节 you click on the image andhold down the mouse button while you move the 
cursor, pixval also displays the Euclidean distance between the point you 
clicked on and the current cursor location. pixval drawsgs a line between these 
points to indicate the distance being measured. When you release the mouse 
button, the line and the distance display qisappear. 


You can move the display bar by clicking on it and dragging itito another place 
in the fgure. 


pixval off turns interactive display offin the current figure. You can also turn 
offthe display by clicking the button on the right side of the display bar. 


pixval toggles interactive display on or off in the current 和 gure. 


pixval(fig,option) applies the pixval command to the figure specified by 
fig. option ls String containing 'on' or 'off '. 


ImpIxe1l， improfile 


14-315 


Psf2otf 





PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 


See Also 
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Convert point-spread function to optical transfer function. 


OTF = psf2otf(PSF ) 
OTF = psf2otf(PSF,OUTSIZE ) 


OTF = psf2otf(PSF) computes the Fast Fourier Transform (FFT) ofthe 
point-spread function (PSF) array and creates the optical transfer function 
array, 0TF, that is not influenced by the PSF off-centering. By default, the OTF 
arTray is the same Size as the PSF array. 


OTF = psf2otf(PSF,0OUTSIZE) converts the PSF array into an OTF array, where 
OUTSIZE specifies the size ofthe OTF array. The OUTSIZE cannot be smaller than 
the PSF array size in any dimension. 


To ensure that the OTF is not altered due to PSF off-centering, psf2otf 
post-pads the PSF array (down or to the right) with zeros to match dimensions 
specified in OUTSIZE, then circularly shifts the values ofthe PSF array up (or to 
the left) until the central pixel reaches (1,1) position. 


Note that this function is used in image convolution/deconvolution when the 
operations involve the FFT. 


PSF can be any nonsparse, numeric array. 0TF is of class doub1e. 


PSF = fspecial('gaussian' ,13，,1) ; 

OTF = psf2otf(PSF,[31 31]); % PSF --> OTF 

Subplot(1,2,1); Surf(PSF); title('PSF' ) ; 

axis Square;j axis tight 

Subplot(1,2,2); surf(abs(OTF)); title('corresponding |OTF| ); 
axis Square;j axis tight 


otf2psf, circshift, padarray 
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Purpose 


Syntax 


Descripfion 


Perform quadtree decomposition 


S = qtdecomp(I) 

S = qtdecomp(I,threshold ) 

S = qtdecomp(I,threshold,mindinm) 

S = qtdecomp(I,threshold, [mindim maxdim]) 


S = qtdecomp(I,fun) 
S = qtdecomp(I,fun,P1,P2,...) 


qtdecomp divides a square image into four equal-sized square blocks, and then 
tests each block to see 这 it meets some criterion of homogeneity. If a block 
meets the criterion, it is not divided any further. Ifit does not meet the 
criterion,it is subdivided again into four blocks, and the test criterion is applied 
to those blocks. This process is repeated iteratively until each block meets the 
criterion. The result may have blocks of several different sizes, 


S = qtdecomp(I) performs a quadtree decomposition on the intensity image IT， 
andreturns the quadtree structure in the sparse matrixS.IfSs(k,m) is nonzero， 
then (k,m) is the upper-left corner ofablock in the decomposition, and the size 
of the block is given by S(k,m). By default, qtdecomp splits a block unless all 
elements in the block are equal. 


S = qtdecomp(I,thresho1d) splits a block ifthe maximum value ofthe block 
elements minus the minimum value of the block elements is greater than 
threshold. threshold is specified as a value between 0 and l, even 放 Iis of 
class uint8 or uint16. IfIis uint8, the threshold value you Supply is 
multiplied by 255 to determine the actual threshold to use; ifIis uint16, the 
threshold value you supply is multiplied by 65535. 


S = qtdecomp(I,threshold,mindim) will not produce blocks smaller than 
mindim, even 过 the resulting blocks do not meet the threshold condition. 


S = qtdecomp(I,threshold,[mindim maxdim]) will not produce blocks 
smaller than mindimorlargerthan maxdim.Blocks largerthan maxdim are split 
even 过 they meet the threshold condition. maxdim/mindimmustbe apower of2. 


S = qtdecomp(I,fun) uses the function fun to determine whether to split a 
block. qtdecomp calls fun with all the current blocks of size m-by-m stacked into 
an m-by-m-by-k array, where k is the number ofm-by-mblocks. fun should return 
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dtdecomp 





Class Suppor 


Remarks 


Example 
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a k-element vector, containing only ls and 0's, where 1 indicates that the 
corresponding block should be split, and 0 indicates it should not be split. (For 
example, 这 k(3) is 0, the third m-by-m block should not be split.) fun can be a 
function_handle, created using e, or an inline object. 


S = qtdecomp(I,fun,P1,P2,...)passes P1,P2,...，asadditional arguments 
to fun. 


For the syntaxes that do not include a function, the input image can be ofclass 
1ogical, uint8, uint16, or doub1e. For the syntaxes that include a function， 
the input image can be of any class Supported by the function. The output 
matrix is always of class sparse. 


qtdecomp is appropriate primarily for square images whose dimensions are a 
power of 2, such as 128-by-128 or 512-by-512. These images can be divided 
until the blocks are as small as 1-by-1. 节 you use qtdecomp with an image 
whose dimensiongs are not a power of 2, at some point the blocks cannot be 
divided farther. For example, if an imasge is 96-by-96, it can be divided into 
blocks of size 48-by-48, then 24-by-24, 12-by-12, 6-by-6, and finally 3-by-3. No 
further division beyond 3-by-3 is possible. To process this image, you must set 
mindimto3(orto 3tmesapowerof2);ifyou are usingthesyntaxthat includes 
a fanction, the function must return 0 at the point when the block cannot be 
divided farther. 


I= [1 1 1 1 2 3 6 6 
1 1 2 1 4 5 6 8 
1 1 1 1 10 15 7 7 
1 1 1 1 20 25 7 7 
20 22 20 22 1 2 3 4 
20 22 22 20 5 6 7 8 
20 22 20 20 9 10 11 12 
22 22 20 20 13 14 15 161] ; 


S = qtdecomp(I,5) ; 


fuJll(S) 


qtdecomp 





ans 


qtgetb1]lk, qtsetb1lk 


See Also 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 


Example 
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Get block values in quadtree decomposition 


[vals,r;,cl 
[vals,idx] 


qtgetblk(I,S,dinm) 
qtgetblk(I,S,dinm) 


[vals,r,c]l = qtgetblk(I,S,dim) returns in vals an array containing the 
dim-by-dim blocks in the quadtree decomposition of I. S is the sparse matTrix 
returned by qtdecomp; it contains the quadtree Structure. vals is a 
dim-by-dim-by-k array, where k is the number of dim-by-dim blocks in the 
quadtree decomposition; 这 there are no blocks ofthe specified size, all outputs 
are returned as empty matrices. Fr and c are vectors containing the row and 
column coordinates of the upper-left corners of the blocks. 


[vals,idx] = qtgetblk(I,S,dim) returns in idx a vector containing the 
linear indices ofthe upper-left corners of the blocks. 


I can be ofclass 1ogical, uint8, uint16, or double. S is of class sparse. 


The ordering ofthe blocks in vals matches the colummnwise order ofthe blocks 
in I. For example, ifvals is 4-by-4-by-2, vals(:，,: ,1) contains the values 位 om 
the first 4-by-4block in I, andvals(:,:,2) contains thevalues 位 om the second 
4-by-4 block. 


This example continues the qtdecomp example. 


[vals,r,cl = qtgetblk(I,S,4) 


vals(:),: 1) = 


和 
和 
vi 
二 和 二 和 


qtgetbjk 





See Also 


vals(:，:，2) 
20 22 
20 22 
20 22 
22 22 
广 三 
1 
5 


qtdecomp, qtsetb1lk 


20 
22 
20 
20 


22 
20 
20 
20 
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qtsetblk 





PurPpose 
Syntax 


Descripfion 


Class Suppor 


Remarks 


Example 


See Also 
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Set block values in quadtree decomposition 


J = qtsetblk(I,S,dim,vals) 


J = qtsetblk(I,S,dim,vals) replaces each dim-by-dim block in the quadtree 
decomposition of I with the corresponding dim-by-dim block in vals. S is the 
sparse matrix returned by qtdecomp; it contains the quadtree structure. vals 
is a dim-by-dim-by-k array, where k is the number of dim-by-dim blocks in the 
quadtree decomposition . 


I can be ofclass 1ogical, uint8, uint16, or double. S is of class sparse. 


The ordering of the blocks in vals must match the colummnwise order of the 
blocks in I. For example, ifvals is 4-by-4-by-2, vals(:，,:,1) contains the 
values used to replace the first 4-by-4 block in I,and vals(:,:,2) contains the 
values for the second 4-by-4 block. 


This example continues the qtgetblock example. 


newvals = cat(3,zeroSs(4),ones(4) ) ; 
J = qtsetblk(I,S,4,newvals ) 


J = 
0 0 0 0 2 3 6 6 
0 0 0 0 4 5 6 8 
0 0 0 0 10 15 7 7 
0 0 0 0 20 25 7 7 
1 1 1 1 1 2 3 4 
1 1 1 1 5 6 7 8 
1 1 1 1 9 10 11 12 
1 1 1 1 13 14 15 16 


qtdecomp, qtgetb1lk 
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Purpose Radon transform 


Syntax R = radon(I,thetal) 
[R,xp] = radon(...) 


Descripfion The radon fanction computes the Radon transform, which is the projection of 
the image intensity along aradial line oriented at a specified angle. 


R = radon(I,theta) returns the Radon transform ofthe intensity image I for 
the angle theta degrees. Iftheta is a scalar, the result R is a column vector 
containing the Radon transform for theta degrees. Iftheta is a vector, then R 
is amatrix in which each column is the Radon transform for one of the angles 
in theta. Ifyou omit theta, it defaults to 0:179. 


[R,xp] = radon(...) returns avector xp containing the radial coordinates 
Corresponding to each row of R. 


Class Supporf I can be of class double, 1ogical,， or of any integer class. All other inputs and 
outputs are of class doub1e. 


Remarks Theradial coordinates returned in xp are the values along thex'-axis, which is 
oriented at theta degrees counterclockwise from the x-axis. The origin of both 
axes is the center pixel of the image, which is defined as 


floor((Size(I)+1)/2) 


For example, in a 20-by-30 image, the center pixel is (10,15). 


Example iptsetpref( '` ImshowAxeSVisible' ，on') 
II = zeros(100,100) 
I(25:75,25:75) = 1; 
theta = 0:180 
[R,xp] = radon(I,theta) ; 
Imshow(theta,xp;,R,[]，notruesize')，colormap(hot)，colorbar 
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radon 








70 
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See Also iradon, phantom 


References Bracewell, Ronald N. Two-Dimzemsiompal 177rasz15. Englewood Cliffs, NJ: 
Prentice Hall, 1995. pp. 505-537. 


Lim, Jae $. Tuo-DimmzemsioPpal SiSsmal aa 17rase Process1105.Englewood Cliffs， 
NJ: Prentice Hall, 1990. pp. 42-45. 
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reflecft 





Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 


Reflect structuring element 
SE2 = reflect(SE) 


SE2 = reflect(SE) reflects a structuring element through its center. The 
effect is the same as 让 you rotated the structuring element's domain 180 
degrees around its center (for a 2-D structuring element). If SE is an array of 
structuring element objects, then reflect(SE) reflects each element of SE, and 
SE2 has the same Size as SE. 


SE and SE2 are STREL objects. 


Se = Strel([001;000;000]) 

Se2 = reflect(Sse) 

Se = 

Flat STREL object containing 1 neighbor， 


Neighborhood : 
0 0 1 
0 0 0 
0 0 0 
Se2 = 


Flat STREL object containing 1 neighbor， 


Neighborhood : 
0 0 0 
0 0 0 
1 0 0 
StreJ 
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regionprops 





PurPpose 
Syntax 


Descripfion 


Definifions 
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Measure properties of image regions 
STATS = regionprops(L,properntIesS ) 


STATS = regionprops(L,properties) measures a set of properties for each 
labeled region in the label matrix L. Positive integer elements of L correspond 
to different regions. For exzample, the set ofelements ofL equalto 1 corresponds 
to region 1; the set of elements of L equal to 2 corresponds to region 2; and so 
on. The return value, STATS, is a Structure array of length max(L(:)). The 
fieldqs ofthe structure array denote different measurements for each region, as 
specified by propertIies. 


properties can be a comma-separated list of strings, a cell array containing 
strings, the single string 'all',or the string 'basic' .This table lists the set 
of valid property Strings. Property strings are case insengsitive and can be 
abbreviated. 





Area， `“EquivDiameter 'MajorAxisLength 
"BoundingBox- "EULerNumber 'MinorAxisLength 
"Centroid “EXtent Orientation' 
"ConveXxArea， “EXxtrema， “PiIXxeJIdxList， 
"ConveXxHu11]- FilledArea， “PiIXxelList- 
ConveXxImage FilledImage- 'SolLidity 
"ECccentricity "Image ， 'SubarrayIdXx 





Ifproperties is the string 'all' ,then all ofthe above measurements are 
computed. Ifproperties is not specified or ifit is the string 'basic',then 
these measurements are computed: 'Area'，'Centroid ' ,and 'BoundingBox '. 


'Area' -SScalar; the actual number of pixels in the region. (This value may 
differ slightly 他 om the value returned by bwarea, which weights different 
patterngs of pixels differently.) 


'Centroid ' - 1-by-ndims(L) vector; the center ofmass ofthe region. Note that 
the first element of Centroid is the horizontal coordqinate (or X-coordinate) of 


regionprops 





the center of mass, and the second element is the vertical coordinate (or 
y-coordinate). All other elements of Centroid are in order of dimension 


'BoundingBox ' -- 1-by-ndims(L)*2 vector; the smallest rectangle containing 
the region. BoundingBox is [ul_corner width], where 


UL_corner is in theform [x y z ...]andspecifes the upper-le 化 
corner of the bounding box 


width is in the form [x_ width y_width ...] andspecifies 
the width of the bounding box along each qimension 


This fgureillustrates the centroid and bounding box. The region consists ofthe 
white pixels; the green box is the bounding box, and the red dot is the centroid. 





'MajorAxisLength ' -SScalar; the length (in pixels) ofthe major axis of the 
ellipse that has the same second-moments as the region. This property is 
Supported only for 2-D input label matrices， 


'MinorAxisLength ' - Scalar; the length (in pixels) ofthe minor axis ofthe 
ellipse that has the same second-moments as the region. This property is 
Supported only for 2-D input label matrices， 


'Eccentricity' 一 Scalar; the eccentricity ofthe ellipse that has the same 
second-moments as the region. The eccentricity is the ratio of the distance 
between the foci ofthe ellipse and its major axis length. The value is between 
0 and 1. (0 and 1 are degenerate cases; an ellipse whose eccentricity is 0 is 
actually a circle, while an ellipse whose eccentricity is 1 is aline segment.) This 
property is Supported only for 2-D input label matrices. 


'Orientation' -SScalar; the angle (in degrees) between the x-axis and the 
major axis ofthe ellipsethat has the same second-moments as the region. This 
property is Supported only for 2-D input label matrices. 
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This fgure illustrates the axes and orientation ofthe ellipse. The left side of 
the figure shows an image region and its corresponding ellipse. The right side 
shows the same ellipse, with features indicated graphically; the solid blue lines 
are the axes, the red dots are the foci, and the orientation is the angle between 
the horizontal dotted line and the major axis. 





'Image' -Binary image (1ogical) ofthe same size as the bounding box ofthe 
region; the on pixels correspond to the region, and all other pixels are off. 


'FilledImage' -Binary imnage (1ogical)ofthe same size as the bounding box 
of the region. The on pixels correspond to the region, with all holes filled in. 


'FilledArea' -SScalar; the number of on pixels in Fi1lledImage. 


This fgure illustrates Image' and FilledImage '. 





和 


0riginal image, containing d single 'Image'， 'FilledImage'， 
region 


'ConvexHu11' - p-by-2 matrix; the smallest convex polygon that can contain 
the region. 也 ach row of the matrix contains the x- and y-coordinates of one 
vertex of the polygon. This property is Supported onjly for 2-D input label 
Imatriceg. 


regionprops 





'ConvexImage ' - Binary image (1ogical); the convex hull, with all pixels 
within the hull flled in (ie., set to on). (For pixels thatthe boundary ofthe hull 
passes through, regionprops uses the same logic as roipoly to determine 
wphether the pixel is inside or outside the hull.) The image is the size of the 
bounding box ofthe region. This property is Supported only for 2-D input label 
Iatriceg. 


'ConvexArea ' -SScalar; the number of pixels in 'ConvexImage'.This property 
is Supported only for 2-D input label matrices. 


'EulerNumber ' -SScalar; equal to thenumber ofobjects in the region minus the 
number ofholes in those objects. This property is supported only for 2-D input 
label matrices. 


'Extrema' -- 8-by-2 matrix; the extremal points in the region. 了 bach row ofthe 
matrix contains the x- andy-coordinates of one ofthe points. The format ofthe 
vector 18 [top-left top-right right-top right-bottom bottom-right 
bottom-1left left-bottom Left-top].This property is Supported only for 2-D 
input label matrices. 


This figure illustrates the extrema oftwo different regions. In the region on the 
left, each extremal point is distinct; in the region on the right, certain extremal 
points (e.g., top-left and Left-top) are identical. 


top-|eff top-riglt top-|e 仁 top-right 





|eff-iop right-top |eff-fop right-top 





|eft-bottom right-bottom |eff-bottom right-bottom 





bottom-lef bottom-right bottom-lef bottom-right 


'EquivDiameter ' --Scalar; the diameter of a circle with the same area as the 
region. Computed as sqrt(4*Area/pi).This property is Supported only for 2-D 
input label matrices. 


'Solidity' -SScalar; the proportion of the pixels in the convex hull that are 
also in the region. Computed as Area/ConvexArea. This property is Supported 
only for 2-D input label matrices. 


14-329 


regionprops 





Class Suppor 


Remarks 
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'Extent ' - Scalar; the proportion of the pixels in the bounding box that are 
also in the region. Computed as the Area divided by area of the bounding box. 
This property is Supported only for 2-D input label matrices. 


'PixelList' 一 p-by-ndims(L) matrix; the actual pixels in the region. 卫 ach row 
of the matrix has the form [x y z ...]andspecifies the coordinates ofone 
pixel in the region. 


The input label matrix L can have any numeric class, 


The comma-separated list syntax for structure arTrays is very useful when 
working with the output of regionprops. For example, for a field that contains 
asgscalar,youcan use athis syntax to create avector containing the value ofthis 
field for each region in the image. 


For instance, 过 stats is a structure arTray with field Area, then the following 
two expressiongs are equivalent 


Stats(1).Area，Sstats(2).Area，...，Sstats(end).Area 


and 


Stats.Area 


Therefore, you can use these calls to create a vector containing the area of each 
region in the image， 


stats = regionprops(L,'Area' ) 
allArea = [stats.Areal]; 


allArea is a vector of the same length as the structure arTray StatsS. 


The function ismember is useful in conjunction with regionprops for selecting 
regions based on certain criteria.For example,these commands create a binary 
image containing only the regiongs in text.tif whose area is greater than 80. 


工 dX find([stats.Areal > 80) 
BW2 = Ismember(L, Idx) ; 


Most of the measurements take very little time to compute. The exceptions are 
these, which maytake significantly longer, depending on the number ofregions 
in L: 


e ConveXxHUuU11， 


regionprops 





ee ConvexImage， 
ee ConveXxArea， 
ee FillJedImage， 


Note that computing certain groups of measurements takes about the same 
amount of time as computing just one of them because regionprops takes 
advantage ofintermediate computations used in both computations. Therefore， 
it is fastest to compute all of the desired measurements in a single call to 


regionprops. 
Example BW = imread('text.tif') ; 
L = bwlabel(BW) ; 
Stats = regionprops(L，all ) 
Stats(23) 
ans = 
Area: 89 
Centroid: [95.6742 192.9775] 
BoundingBox: [87.5000 184.5000 16 15] 
MajorAxisLength: 19.9127 
MinorAxisLength: 14.2953 
Eccentricity: 0.6961 
orientation: 9.0845 
ConvexHu11: [28x2 double] 
ConvexImage: [15x16 uint8 ] 
ConveXxArea: 205 
Image: [15x16 uint8 ] 
FilledImage: [15x16 Uint8 ] 
FiIl11ledArea: 122 
EULerNumber: 0 
Extrema: [ 8x2 double] 
EqulivDiameter: 10.6451 
Solidity: 0.4341 
EXxtent: 0.3708 
PixelList: [89x2 double] 


See Also 


bwlabel1, bwlLlabeln, Ismember, watershed 


ismember jg a MATLAB function 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Algorithm 


See Also 
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Convert an RGB image or colormap to grayscale 


I = rgb2gray(RGB ) 
newmap = rgb2gray (map ) 


rgb2gray converts RGB images to grayscale by eliminating the hue and 
saturation information while retaining the luminance. 


I = rgb2gray(RGB) converts the truecolor image RGB to the grayscale intensity 
Image I. 


newmap = rgb2gray(map) returns a grayscale colormap equjivalent to map, 
Ifthe input is an RGB image, it can be of class uint8, uint16, or double. The 
output image, I, is ofthe same class as the input image. Ifthe inputis a 


colormap, the input and output colormaps are both of class doub1le. 


rgb2gray converts the RGB values to NTSC coordinates, sets the hue and 
saturation components to zero, and then converts back to RGB color space. 


ind2gray, ntsc2rgb, rgb2ind, rgb2ntsc 


rgb2hsv 





Purpose Convert RGB values to hue-saturation-value (HSV) color Space 


rgb2hsv is a function in MATLAB. To get help for this function, select 
MATLAB Help from the Help menu and view the online fanction reference 


Pages. 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Remarks 
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Convert an RGB image to an indexed image 


[X,map] rgb2ind(RGB ,tol) 

[X,map] rgb2ind(RGB ,n) 

X = rgb2ind(RGB ,map) 

[...] = rgb2ind(... ,ozthner optIzon) 


rgb2ind converts RGB images to indexed images using one of three different 
methods: uniform quantization, minimum variance quantization, and 
colormap mapping. For all ofthese methods, rgb2ind also dithers the image 
unless you Specify 'nodither' for dither_option， 


[X,map] = rgb2ind(RGB ,to1l) converts the RGB image to an indexed image X 
using uniform quantization. map contains at most (floor(1/tol)+1)^3 colors. 
tol must be between 0 and 1.0. 


[X,map] = rgb2ind(RGB,n) converts the RGB image to an indexed image X 
using minimum variance quantization.map contains at most n colors. nmust be 
less than or equal to 65536. 


X = rgb2ind(RGB,map) converts the RGB image to an indexed image X with 
colormap map by matching colors in RGB with the nearest color in the colormap 
map. Size(map,1) must be less than or equal to 65536. 


[...] = rgb2ind(...,oqither option) enables or disables qithering. 
dzther_ option is a string that can have one ofthese values: 


e 'dither' (default) dithers, ifnecessary, to achieve better color resolution at 
the expense of spatial resolution . 


e 'nodither' maps each color in the original imasge to the closest color in the 
new map. No dithering is performed. 


The input image can be ofclass uint8, uint16, or double. 开 the length of map 
is less than or equal to 256, the output image is of class uint8. Otherwise, the 
output image is of class uint16. 


H 开 you specify tol, rgb2ind uses uniform quantization to convert the image. 
This method involves cutting the RGB color cube into smaller cubes of length 
to1. For example, 让 you specify a tol of 0.1, the edges ofthe cubes are 
one-tenth the length of the RGB cube. The total number of small cubes is 


rgb2ind 





n= (floor(1/tol)+1)^3 


卫 ach cube represents a single color in the output image. Therefore, the 
maximum length ofthe colormap is n. rgb2ind removes any colors that dont 
appear in the input image, so the actual colormap may be much smaller than n. 


H 开 you specify n, rgb2ind uses minimum variance quantization. This method 
involves cutting the RGB color cube into smaller boxes (not necessarily cubes) 
of different sizes, depending on hovw the colors are distributed in the image. 形 
the input image actually uses fewer colors than the number you specify, the 
output colormap is also smaller. 


Ifyou specify map, rgb2ind uses colormap mapping, which involves finding the 
colors in map that best match the colors in the RGB image. 


Example RGB = imread('flowers.tif') ; 
[X,map] = rgb2ind(RGB ,128) ; 
Imshow(X,map) 





See Also cmunidque, dither, imapprox, ind2rgb, rgb2gray 
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PurPpose 


Syntax 


Descripfion 


Remarks 


Class Suppor 


See Also 
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Convert RGB values to NTSC color space 


yiIidqmap = rgb2ntsc(rgbmap ) 
YIQ = rgb2ntsc(RGB) 


yiqmap = rgb2ntsc(rgbmap) converts the m-by-3 RGB values in rpbgmap to 
NTSC color space. yiqmap is an m-by-3 matrix that contains the NTSC 
luminance (了 ) and chrominance (andQ) color components as columns that are 
equivalent to the colors in the RGB colormap, 


YIQ = rgb2ntsc(RGB) converts the truecolor image RGBto the equivalent NTSC 
Image YIQ. 


In the NTSC color space, the luminance is the grayscale signal used to display 
pictures on monochrome (black and white) televisions. The other components 
carry the hue and saturation information. 


rgb2ntsc defines the NTSC components using 


了 0.299 0.587 ”0.114| |j 忆 
了 | = |0.596 -0.274 -0.322|1G 
Q 0.211 -0.523 ”0.312| | 已 


Ifthe input is an RGB image, it can be ofclass uint8, uint16, or double; the 
output imageis ofclass double. Ifthe input is a colormap, the input and output 
colormaps are both of class doub1le. 


ntsc2rgb, rgb2ind, ind2rgb, Ind2gray 


rgb2ycbcr 





Purpose 


Syntax 


Descripfion 


Class Suppor 


See Also 


Convert RGB values to YCbCr color space 


ycbcrmap = rgb2ycbcr(rgbmap) 
YCBCR = rgb2ycbcr(RGB) 


ycbcrmap = rgb2ycbcr(rgbmap) converts the RGB values in rbgmap to the 
YCbCr color space. ycbcrmap is an m-by-3 matrix that contains the YCbCr 
luminance (了 ) and chrominance (Ce and Cr) color components as columns. 

卫 ach row represents the equivalent color to the corresponding row in the RGB 
colormap. 


YCBCR = rgb2ycbcr(RGB) converts the truecolor image RGB to the equivalent 
image in the YCbCr color space, 


Ifthe input is an RGB image, it can be ofclass uint8, uint16, or doubple; the 
output image is ofthe same class as the input image. Ifthe input is a colormap， 


the input and output colormaps are both of class doub1le. 


ntsc2rgb, rgb2ntsc, ycbcr2rgb 
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PurPpose Plot colormap 


rgbplot is a MATLAB function. To get help for this fanction, select MATLAB 
Help 们 om the Help menu and view the online function reference page. 
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Purpose Select region of interest, based on color 
Syntax BW = roicolor(A,Low,high) 
BW = roicolor(A,V) 
Descripfion roicolor selects a region of interest within an indexed or intengsity image and 


returns a binary image. (Youcan use the returned image as amask for masked 
在 ltering using roifilt2.) 


BW = roicolor(A,Low,high) returns aregion of interest selected as those 
pixels that lie within the colormap range [1ow high]. 


BW = (A >= low) & (A <= high) 
BW is a binary image with 0's outside the region of interest and 1's inside， 


BW = roicolor(A,v) returngs a region of interest selected as those pixels in A 
that match the values in vector v. BW is a binary image with 1s where the 
values of A match the values of v. 


Class Supporf The input imnage, A, must be numeric. The output image, BW, is ofclass 1ogical. 


Example I = imread('rice.tif') | 
BW = roicolor(I,128,255) ; 
Imshow(I) ; 


figure，imshow(BW) 





See Also roifilt2, roipoly 
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PurPpose 


Syntax 


Descripfion 
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Smoothly interpolate within an arbitrary image region 


伍 : 
1 


= roifill(I,Ccyr) 
roifil1l(I) 


> 
中 


J = roifil1(I,BW) 
[J,BW] = roifil1(...) 


J = roifil1(x;y,I, Xi yiI) 
[x,y,J,BW,Xxi,yi]l = roifil1(...) 


roifil1 磋 lls in a specified polygon in an intensity image. It smoothjly 
interpolates inward fom the pixel values on the boundary of the polygon by 
solving Laplace's equation. roifill can be used, for example, to“erase”small 
objects in an imasge. 


J = roifill(I,cr) fllsin the polygon specified by c and r, which are 
equal-length vectors containing the row-column coordinates of the pixels on 
vertices of the polygon. The k-th vertex is the pixel (Fr(k),c(k) ). 


J = roifil1l(I) displays the image I on the screen and lets you specify the 
polygon using the mouse. Ifyou omit I, roifil1l operates on the image in the 
current axes. Use normal button clicks to add vertices to the polygon. Pressing 
Backspace or Delete removes the previously selected vertex. A shift-click， 
Tight-click, or double-click adds a final vertex to the selection and then starts 
the 有 1; pressing Return finishes the selection without adding a vertex. 


J = roifil1l(I,BW) uses BW (a binary imasge the same size as TI) as a mask. 
roifil11 磋 lls in the regions in I corresponding to the nonzero pixels in BW. 下 
there are multiple regions, roifill performs the interpolation on each region 
independently， 


[J,BW] = roifil1(...) returns the binary mask used to determine which 
pixels in I get flled. BW is a binary image the same size as I with ls for pixels 
corresponding to the interpolated region of I and 0's elsewhere. 


J = roifil1(x,y,I,xi,yi) usesthe vectors x and y to establish a nondefault 
spatial coordinate system. xi and yi are equal-length vectors that specify 
polygon vertices as locations in this coordinate System 


roif| 





[x,y,J,BW,xi,yil = roifil1(...) returns the XData and YData in x and y; 
the output image in J; the mask image in BW; and the polygon coordinates in xi 
andyi. xiandyiare emptyifthe roifil1(I,BW) form is used. 


Ifroifillis called with no output arguments,the resulting image is displayed 
in a nevw figure. 


Class Support The input image I can of class uint8, uint16, or double. The input binary 
mask, BW, can be any numeric class or 1ogical. The output binary mask, BW, js 
always 1ogical.The output image J is ofthe same class as I. All other inputs 
and outputs are of class doub1le, 





Example I = imread('eight.tif' ) ; 
C = [222 272 300 270 221 1941] ; 
Fr= [21 21 75 121 121 75] ; 
J = roifill(I, cr) 
Imshow(I) 
figure，imshow(Jy) 
See Also roifilt2, roipoly 
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PurPpose 


Syntax 


Descripfion 


Class Suppor 


Example 
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Filter a region of interest 


J = roifilt2(h,I,BW) 
roifilt2(I,BW,fun) 
Jd = roifilt2(I,BW,fun,P1,P2,...) 


Er 
中 


J = roifilt2(h,I,BW) flters the data in I with the two-dqimensional linear 
和 lter h. BW is a binary image the same size as Ithat is used as a mask for 

和 ltering. roifilt2 returns an image that consists of fltered values for pixels 
in locations where BW contains ls, and unfiltered values for pixels in locations 
where BW contains 0s. For this Syntax, roifilt2 calls filter2 to imnplement 
the 下 lter. 


J = roifilt2(I,BW,fun) processes the data in I using the function fun. The 
result J contains computed values for pixels in locations where BW contains 1S， 
and the actual values in I for pixels in locations where BW contains 0?S. 


fun can beafunction _handle, created using e, or an inline object. fun should 
take a matrix as a single argument and return amatrix ofthe same size. 


y = fun(Xx) 
J = roifilt2(I,BW,fun,P1,P2,...) passes the additional parameters 
P1,P2,...，tofun. 


Forthe syntaxthat includes afilter, h,the input image, I, can beofclass uint8， 
uint16, or double, and the output array, J, has the same class as the input 
image. For the syntax that includes a function, I can be of any class Supported 
by fun, and the class of J depends on the class of the output 位 om fun. 


This example continues the roipoly example. 


工 imread(' eight .tif ' ) ; 

C = [222 272 300 270 221 194] ; 
Fr= [21 2175 121 121 75] | 

BW = roipoly(I, cr) 

h = fspecial( unsharp ) ; 

J = roifilt2(h;,I,BW) ; 
imshow(J)，Tfigure，imshow(JU) 


roifil+2 








See Also filter2, roipoly 


14-343 


roipoly 





PurPpose 


Syntax 


Descripfion 
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Select a polygonal region of interest 


BW = roipoly(I,cyr) 
BW roipoly(I) 


BW roipoly(x;y，I ,XI yiI) 
[BW,Xxi,yil = roipoly(...) 
[x,y,BW,Xxi,yi]l = roipoly(...) 


Use roipoly to select a polygonal region of interest within an image. roipoly 
returns a binary image that you can use as a mask for masked filtering. 


BW = roipoly(I,cir) returns the region of interest selected by the polygon 
described by vectors c and r. BW is a binary image the same size as I with 0?S 
outside the region of interest and ls inside. 


BW = roipoly(I) displays the image I on the screen and lets you specify the 
polygon using the mouse. Ifyou omit I, roipoly operates on the image in the 
current axes. Use normal button clicks to add vertices to the polygon. Pressing 
Backspace or Delete removes the previously selected vertex. A shift-click， 
Tight-click, or double-click adds a final vertex to the selection and then starts 
the 有 1; pressing Return finishes the selection without adding a vertex. 


BW = roipoly(x,y,I,xi,yi) usesthe vectors x and ytoestablish anondefault 
spatial coordinate system. xi and yi are equal-length vectors that specify 
polygon vertices as locations in this coordinate System 


[BW,xi,yi]l = roipoly(...) returns the polygon coordinates in xi and yi. 
Note that roipoly always produces a closed polygon. Ifthe points specified 
describe a closed polygon (i.e., 这 the last pair of coordinates is identical to the 
first pair), the length ofxi and yiis equal to the number ofpoints specified. 工 
the points specified do not describe aclosed polygon, roipoly adds afinal point 
having the same coordinates as thefirst point. (In this casethelength ofxiand 
yi is one greater than the number of points specified.) 


[x,y,BW,xi,yil = roipoly(...) returns the XData and YDatain x and y; the 
mask imnage in BW; and the polygon coordinates in xi and yi 


Ifroipoly is called with no output arguments,theresulting image is displayed 
in anevw fgure. 


roipoly 





Class Suppor 


Remarks 


Example 


See Also 


The input image I can be ofclass uint8, uint16, or double. The output image 
BW is of class 1ogical. All other inputs and outputs are of class doub1le. 


For any of the roipoly syntaxes, you can replace the input image I with two 
arguments,mandn,that specify therow and column dimensions ofan arbitrary 
image. For example, these commands create a 100-by-200 binary mask. 


C= [112 112 79 79] ; 
= [37 66 66 37]; 
BW = roipoly(100,200,cr) 


H 开 you specify m and n with an interactive form of roipoly, an m-by-n black 
image is displayed, and you use the mouse to specify a polygon within this 
image， 


II = imnread(' eight.tif' ) ; 

C = [222 272 300 270 221 194] ; 
= [21 21 75 121 121 75] ; 

BW = roipoly(I,，cyr) 

Imshow(I) 

figure，imshow(BW) 





roifilt2, Proicolor, Foif1i1l1] 
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PurPpose Compute the standard deviation ofthe elements of a matrix 
Syntax b = std2(A) 
Description b = std2(A) computes the standard deviation ofthe values in A. 


Class Support 。 A can be numeric or logical. B is a scalar of class doub1le. 
Algorithm std2 computes the standard deviation ofthe array Ausing std(A(:) ). 


See Also corr2, mean2 


std, mean in the MATLAB Function Reference 
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Purpose 
Syntax 


Descripfion 


Create morphological structuring element 
SE = strel(shape,parameters) 


SE = strel(shape,parameters) creates a structuring element, SE, ofthe type 
specified by shape. This table lists all the supported shapes. Depending on 
Shape, strel maytake additional parameters. See the syntax descriptions that 
follow for details about creating each type of structuring element. 





Flat Structuring Elements 


“arbitrary， pair 
:diamond ， "periodicline， 
“disk， PPectang1e， 

"1 工 Lne， “Square ， 
“Octagon， 


Nonflat Siructuring Elements 


“arbitrary， "bal1， 





SE = strel('arbitrary',NHOOD) creates aflat structuring element， where 
NHOOD specifies the neighborhood. NHOOD is a matrix containing 1s and 0's; the 
location ofthe 1's defines the neighborhood for the morphological operation . 
The center (or orzgI7) of NHOOD is it's center element, given by 
floor((size(NHOOD)+1)/2).Youcanomitthe 'arbitrary' string andjustuse 
strelLl(NHOOD ) . 


SE = 0rigin 

1 0 

1 (0D) 0 
0 


1 1 





NHOOD = [ 10 0; 100;101]; 
SE = strel('arbitrary',NHOOD,HEIGHT) creates a nonflat structuring 


element, where NHOOD specifies the neighborhood. HEIGHT is a matrix the same 
size as NHOOD containing the height values associated with each nonzero 
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element of NH00D. The HEIGHT matrix must be real and finite valued. You can 
omit the 'arbitrary' string and just use strelL(NHOOD ,HEIGHT ) . 


SE = strel('ball',R,H,N) creates anonflat, “ball-shapedq”(actually an 
ellipsoidq) structuring element whose radius in the X-Y plane is R and whose 
height is H. Note that Rimust be anonnegative integer, H must be areal scalar， 
and N must be an even nonnegative integer. When N is greater than 0, the 
ball-shaped structuring element is approximated by a sequence of N nonflat， 
line-shaped structuring elements. When N equals 0, no approximation is used， 
and the structuring element members comprise all pixels whose centers are no 
greater than R away 人 from the origin. The corresponding height values are 
determined 他 om the formula of the ellipsoid specified byR and H. IfNis not 
specified, the default value is 8. 





Nofte Morphological operations run much faster when the structuring 
element uses approximations (N>0) than when it does not (N=0). 





SE = strel('diamond',R) creates aflat, diamond-shaped structuring 
element, where R specifies the distance from the structuring element origin to 
the points ofthe diamond. R must be a nonnegative integer scalar. 





SE = 0rigin 
0 0 0 1 0 0 
0 0 1 1 1 0 0 
0 1 1 1 1 0 
1 R=3 1 j 
0 1 1 1 1 1 0 
0 0 1 1 1 0 0 
0 0 0 1 0 0 0 











SE = strel('disk',R;,N) creates aflat, disk-shaped structuring element， 
where R specifies the radius. R must be a nonnegative integer. N must be 0, 4， 
6, or 8. When N is greater than 0, the disk-shaped structuring element is 
approximated by a sequence of N periodic-line structuring elements. When N 
equals 0, no approximation is used, and the structuring element members 
comprise all pixels whose centers are no greater than R away 位 om the origin. 
INis not specified, the default value is 4. 


strel| 








Nofe Morphological operations run much faster when the structuring 
element uses approximations (N>0) than when it does not (N=0). Howevem， 
structuring elements that do not use approximations (N=0) are not suitable for 
computing granulometries. Sometimes it is necessary for strel to use two 
extra line structuring elements in the approximation, in which case the 
number of decomposed structuring elements used is N+2. 








SE= 0rigin 
0 0 0 1 0 0 
0 1 1 1 1 1 0 
0 1 R=3l 1 1 0 
1 1 1 1 
0 1 1 1 1 1 0 
0 1 1 1 1 1 0 
0 0 0 1 0 0 0 











SE = strel('1Line',LEN,DEG) createsaflat,linear structuring element, where 
LEN Specifies the length, and DEG specifies the angle (in degrees) of the line, as 
measured in a counterclockwise direction 他 om the horizontal axis. LEN is 
approximately the distance between the centers of the structuring element 
members at opposite ends ofthe line. 





























SE= 0rigin 
1 1 1 人) 1 
只 > 

LEN=9 DEG=0 
Origin 
0 
0 0 
1 0 
二 
\ 从 DEG = 45 


SE = strel('octagon',R) creates aflat, octagonal structuring element, where 
R specifies the distance 位 om the structuring element origin to the sides ofthe 
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octagon, as measured along the horizontal and vertical axes. R must be a 
nonnegative multiple of 3. 


SE= 0rigin 





口 口 人 品 
口吃 
| 
CS 


1 
1 
1 
1 
1 


人 
避 避 汪 >) 











SE = strel('pair',0OFFSET) creates aflat structuring element containing two 
members. One member is located at the origin. The second member's location 
is sSpecified by the vector OFFSET. OFFSET must be a two-element vector of 





integers. 
SE= 0rigin 
0 0 0 0 
0 0 0 有 0 
0 0 dd) 0 0 
0 0 册 0 0 
0 0 0 1 











OFFSET= [2 2] 


SE = strel('periodicline',P,V) creates aflat structuring element 
containing 2*P+1 members.Vis atwo-element vector containing integer-valued 
row and column offsets. One structuring element member is located at the 





origin. The other members are located at 1*V，-1x*V, 2*V，-2xV，. ..，Px*V，-Px*V. 
SE= 一 上 
0 0 0 0 0 0 0 1 
0 0 0 0 0 
0 0 0 0 CD 0 0 0 
0 0 1 0 0 0 0 0 0 
1 0 4o0 0 0 0 0 0 0 











Vv= [1 -2] 


SE = strel('rectangle',MN) creates aflat, rectangle-shaped structuring 
element, where MN specifies the size. MN must be a two-element vector of 
Donnegative integers. The first element of MN is the number rowsgs in the 
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Notes 


Methods 


structuring element neighborhood; the second element is the number of 
columns， 


SE= 0rigin 














MN=[3 5] 


SE = strel('square',W) creates asquare structuring element whose width is 
W pixels. Wmust be a nonnegative integer scalar. 


SE= 0rigin 
1 2 


W=3 














For all shapes except 'arbpitrary' ,structuring elements are constructed using 
afamily oftechniques known collectively as s 杂 ctripng ele7ae1t Qeco72DosztIo7， 
The principle is that qilation by some large structuring elements can be 
computed faster by dilation with a sequence of smaller structuring elements. 
For example, qilation by an 11-by-11 square structuring element can be 
accomplished by dilating first with a 1-by-11l structuring element and then 
with an 11-by-l structuring element. This results in a theoretical performance 
improvement of a factor of 5.5, although in practice the actual performance 
improvement is somewhat less. Structuring element decompositions used for 
the 'disk' and 'bal1' shapes are approximations; all other decompositiongs 
are eXact. 


This table lists the methods supported by the STREL object. 





getheight Get height of structuring element 

getneighbors Get structuring element neighbor locations and 
heights 

getnhood Get structuring element neighborhood 





14-351 


strel| 





Example 


Algorithm 


See Also 


References 
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getsedquence 也 xtract Sequence of decomposed structuring 
elements 
isflat Return true for flat structuring element 
reflect Reflect structuring element 
translate Translate structuring element 
Se1 = Strel( square ' ,11) %5 11-by-11 square 
Se2 = Strel('1Line' ,10,45) %5 1ine，1Jlength 10，angle 45 degrees 
Se3 = Strel( 'disk' ,15) #%5 disk，radius 15 
Se4 = Strel('ball' ,15,5) sbal1，radius 15，height 5 


The method used to decompose diamond-shaped structuring elements is 
known as“logarithmic decomposition” [1]. 


The method used to decompose disk structuring elements is based on the 
technique called “radial decomposition using periodic lines”[2], [3]. For details， 
see the MakeDiskStrel subfunction in 
too1lbox/images/images/Qstrel/strel.nm. 


The method used to decompose ball structuring elements is the technique 
called "radial decomposition of sphere”[2|]. 


imdilate,， imerode 


[Rein van den Boomgard and Richard van Balen,“Methods for Fast 
Morphological Image Transforms Using Bitmapped Images,”Co7zpzter Visio7， 
GrapjPzcs, ad 1777raSse Processi11S: G1apAical MIoaels aa 711aagSe Processi10S, vol. 
54, no. 3, May 1992, pp. 252-254. 


[2] RolfAdams “Radial Decomposition of Discs and Spheres,”Co7zpzter 
Vision， Graphics, a12Q 111raSe Processi115: G1aDAical Moaels aq 17zagSe 
Processi1gs, vol. 55, no. 5, September 1993, pp. 325-332. 


[3] Ronald Jones and Pierre S$oille,“Periodic lines: Definition, cascades, and 


application to granulometrie,”Patterm Recos7Pzom Zetters, vol. 17,， 1996， 
1057-1063. 


strefchlim 





Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Find limits to contrast stretch an image 


LOW_HIGH = stretchJlim(I,TOL) 
LOW_HIGH = stretchJlim(RGB,TOL) 


LOW_HIGH = stretchlim(I,TOL) returns a pair of intensities that can be used 
by imadjust to increase the contrast of an imasge. 


TOL = [LOW_FRACT HIGH_FRACT] specifies the fraction ofthe image to saturate 
at low and high intensities. 


I 节 TOL is a scalar, TOL = LOW_FRACT, and HIGH_FRACT = 1 - LOW_FRACT, which 
saturates equal 位 actiongs at low and high intensities. 


Ifyou omit the argument, TOL defaults to [0.01 0.99], saturating 29%2. 
IfTOL = 0,LOW HIGH = [min(I(:)) max(I(:))]. 


LOW_HIGH = stretchlim(RGB ,TOL) returns a 2-by-3 matrix of intensity pairs 
to saturate each plane ofthe RGB image. TOL specifies the same 位 actions of 
saturation for each plane. 


The input image can be of class uint8, uint16, or double. The output 
intensities returned, LOW_HIGH, are of class double and have values between 0 
and 1. 


工 imread( pout.tif ' ) ; 
J= imadjust(I,stretchJlim(I),[]); 
imshow(I)，figure，imshow(Jy ) 
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See Also brighten, histeq, imadjust 
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Purpose 


Syntax 


Descripfion 


Class Suppor 


Example 


Display multiple images in the same fgure 


Subimage 
Subimage 
Subimage (BW) 
Subimage (RGB ) 
Subimage(x;y，...) 
hn = Subimage(...) 


X,map) 
I) 


et 


You can use subimage in conjunction with subp1lot to create figures with 
multiple imnages, even 计 the images have different colormaps. subimage Works 
by converting images to truecolor for display purposes, thus avoiding colormap 
conflicts. 


subimage(X,map) displays the indexed image X with colormap map in the 
CUrrent axXeS. 


subimage(I) displays the intengsity image I in the current axes. 
subimage(BW) displays the binary image BW in the current axes, 
subimage(RGB) displays the truecolor image RGB in the current axes, 


subimage(x,y...) displays an image using anondefault spatial coordinate 
System . 


h = subimage(...) returns ahandle to an image object. 

The input image can be of class logical, uint8, uint16, or doub1le. 
1oad trees 
[X2,map2] = imread( forest.tif ) ; 


Subplot(1,2,1)，subimage(X,map) 
Subplot(1,2,2)，Ssubimage(X2,map2) 
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200 
250 





300 





100 200 300 100 200 300 400 


See Also imshow 
subplot in the MATLAB Function Reference 
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Purpose 
Syntax 


Descripfion 


Spatial transformation of a multidimensional array 


B = tformarray(A,T,R,TDIMS_A,TDIMS_B,TSIZE_B,TMAP_B,F) 


B = tformarray(A,T,R,TDIMS_A,TDIMS_B,TSIZE_B,TMAP_B,F) applies a 
spatial transformation to array Ato produce array B. The tformarray function 
is like imtransform, but is intended forproblems involving higher-dqimensioned 
arrays or mixed input/output dimensionality, or requiring greater user control 
or customization. (Anythingthat can be accomplished with imtransformcan be 
accomplished with a combination of maketform, makeresampler, findbounds， 
and tformarray; but for many tasks involving 2-D images, imtransform is 


Simpler.) 


This table provides a brief description of all the input arguments. See the 
following section for more detail about each argument. (Click on an argument 
in the table to move to the appropriate section.) 








Argument Descripfion 

A Input array or image 

T Spatial transformation structure, called a TFORM， 
typically created with maketform 

R Resampler structure, typically created with 
makereSsamp1Jler 

TDIMS_A Row vector listing the input transform dimensiongs 

TDIMS_B Row vector listing the output transform dimensiongs 

TMAP_B Output array Size in the transform dimensiongs 

TSIZE_B Array of point locations in output space; can be used as 
an alternative way to specify a spatial transformation 

F Array of fll values 





Acan be any nonsparse numeric array, and can be real or complex. 
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TisaTFORM structurethat defines aparticular spatial transformation.For each 
location in the output transform subscript space (as defined by TDIMS_B and 
TSIZE_B), tformarray uses T and the function tforminv to compute the 
corresponding location in the input transform subscript space (as defined by 
TDIMS _A and size(A) ). 


IfTis empty, tformarray operates as a direct resampling function, applying 
the resampler defined in R to compute values at each transform space location 
defined inTMAP BIGfTMAP Bis non-empty), or ateach location in the output 
transform subscript grid. 


R is a structure that defines hovw to interpolate values ofthe input array at 
specified locations. Ris usually created with makeresampler, which allows fine 
control over how to interpolate along each dimension, as well as what input 
array values to use when interpolating close the edge of the array. 


TDIMS AandTDIMS_Bindicate which dimensions ofthe input and output arraysg 
are involved in the spatial transformation. 了 上 ach element must be unique, and 
must be a positive integer. The entries need not be listed in increasing order， 
but the order matters. It specifies the precise correspondence between 
dmensions of arrays AandB and the input and output spaces of the 
transformer, T. length(TDIMS_A) must equal T.ndims_in, and 
LENGTH(TDIMS_B) must equalT.ndims_out. 


For example, ifTis a2-D transformation,TDIMS A= [2 1],andTDIMS B = [1 
2], then the column dimension and row dimension of A correspond to the first 
and second transformation input-space dimensions, respectively. The row and 
column dimensions of B correspond to the first and second output-space 
dimensions, respectively. 


TSIZE_B specifies the size ofthe array B along the output-space transform 
dmensions. Note that the size of B along nontransform dimensions is taken 
directly fom the size of A along those dimensions. If, for exzample,Tis a 2-D 
transformation, size(A) = [480 640 3 10],TDIMS B is [2 1],andqdTSIZE B 
is [300 200],then size(B) is [200 300 31]. 


TMAP_B is an optional array that provides an alternative way of specifying the 
correspondence between the position ofelements ofB and the location in output 
trangsform Space. TMAP_B can be used, for example, to compute the result of an 
image warp at a set of arbitrary locations in output space. IfTMAP_Bis not 
empty, then the size of TMAP_B takes the form: 


tformarray 





[D1 D2 D3 ... DN LI] 


where Nequals length(TDIMS_B). The vector [D1 D2 ... DN] is used in place 
of TSIZE_B. 开 TMAP_B is not empty, then TSIZE_B should be [ ]. 


The value of L depends on whether or not Tis empty. 开 T is not empty, then 上 L 
is T.ndims_out, and each L-dqimension point in TMAP_B is transformed to an 
input-space location usingT.IfTis empty,thenLis length(TDIMS_A), and each 
L-dqimensional point in TMAP_B is used directly as a location in input space. 


F is a double-precision array containing fll values. The fill values in F may be 
used in three Situations: 


e When a separable resampler is created with makeresampler and its 
padmethod is set to either 'fil11' or 'bound '. 


e。 When a custom resampler is used that supports the 'fil1' or 'bound' pad 
methods (with behavior that is specific to the customization). 


e。 When the map from the transform dimensions of B to the transform 
dimensions of Ais deliberately undefined for some points. Such points are 
encoded in the input transform space by NaNs in either TMAP_B or in the 
output of TFORMINYV， 


In the first two cases,fll values are used to compute values for output locationsg 
that map outside or near the edges ofthe input array. Fill values are copied 
into B when output locations map well outside the input array. See 
makeresampler for more information about 'fi1l1' and 'bound '. 


F can be a scalar (including NaN), in which case its value is replicated across al 
the nontransform dimensions. F can also be anonscalar, whose size depends on 
size(A) in the nontransform dimensions. Specifically, if K is the J-th 
nontransform dimension of A, then size(F,J) must be either size(A,K) or 1. 
As a convenience to the user, tformarray replicates F across any dimensiongs 
with unit size such that after the replication size(F,J) equals size(A,K). 


For example, suppose Arepresents 10 RGB images and has size 
200-by-200-by-3-by-10, Tis a 2-D transformation, and TDIMS A and TDIMS_B 
are both [1 2]. In other words, tformarray will apply the same 2-D transform 
to each color plane of each of the 10 RGB images. In this situation you have 
SeVeral optiongs for F: 
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Class Suppor 


Example 


See Also 
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e Fcanbeascalar,in which casethesamefill valueis used for each color plane 
of all 10 images. 

e F can be a 3-by-l vector, [有 GEB]. Then R, G, andB will be used as the fill 
values for the corresponding color planes of each of the 10 images. This can 
be interpreted as specifying an RGB “fill color,”with the same color used for 
all 10 images. 

e F can be a 1-by-10 vector.This can be interpreted as specifying a different 下] 
value for each of 10 images, with thatf]] value being used for all three color 
planes. 


e F can be a 3-by-10 matrix, which can be interpreted as Supplying a different 
RGB fill-color for each ofthe 10 images. 


Acan be any nonsparse numeric array, and can be real or complex. It can also 
be of class 1ogical. 


Create a 2-by-2 checkerboard image where each square is 20 pixels wide, then 
transform it with a projective transformation. Useapadmethod of 'circular' 
when creating aresampler, sothatthe output appears to be a perspective view 
of an infinite checkerboard. Swap the output dimensions. Specify a 100-by-100 
output image. Leave TMAP_B empty, since TSIZE_B is specified. Leave the fill 
value empty, since it wont be needed. 


I = checkerboard(20,1，,1) ; 

figure; imshow(I) 

T = maketform(' projective ' ，[1 1; 41 1; 41 41; 1 41],，..， 
[5 5; 40 5j 35 30; -10 30]) 

R = makereSsampler( cubic' ，circular ) ; 

J = tformarray(I,T,R,[1 2],[2 1],[100 100],[]，[]); 

figure; imshow(J) 


findbounds, imtransform, makeresSsampler, maketfornm 
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Purpose Apply forward spatial transformation 
Syntax X = tformfwd(U,T) 
Descripfion X = tformfwd(U,T) applies the forward transformation defined in Tto each 


row ofu,ifuUis amatrix.Tis aTFORM struct created with maketform, flLiptform， 
or Cp2tform. The argument Uis an M-by-T.ndims_in matrix. 了 ach row of U 
represents a point in Ts input Space. The argument X is an M-by-T.ndims_out 
matrix. 了 Each row ofXrepresents a point in Ts output space, and is the forward 
transformation ofthe corresponding row of U. 


Ifuis an (N+l)-dimensional array (including an implicit trailing singleton 
dmension fT.ndims_inis 1), tformfwd applies the transformation to each 
point U(P1,P2,...,PN,:).Thevalue size(U,N+1) mustequalT.ndims_in. 
The returned array, X, is an (N+l)-dimensional array containing the results of 
each transformation in X(P1,P2,...PN,:).Thevalue size(X,I) equals 
Size(U,I) for I=1,...;,Nandsize(X;,N+1) equalsT.ndims_out. 


Example Create an affine transformation that maps the triangle with vertices (0,0)， 
(6,3), (-2,5) to the triangle with vertices (-1,-1), (0,-10), (-2,5). 
U= [00;63; -2 5] 
Xx= [-1 -1;0 -10; 4 4] 
tform = maketform( affine' ,U,X) 
Validate the mapping by applying tformfwd to Uu. 
tformfwd(u,tform) 各 Result Should equal X 


See Also cp2tform, flLiptform, maketform, tforminv 
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PurPpose 
Syntax 


Descripfion 


Example 


See Also 
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Apply inverse spatial transformation 
U=tforminv(X;,T) 


U = tforminv(X,T) applies the inversetransformation defined in Tto each row 
of X, 让 Xis a matrix.Tis aTFORM struct created with maketform, f1iptform, or 
cp2tform. The argument X is an M-by-T.ndims_out matrix. 了 ach row of X 
represents a point in Ts output space.Uis an M-by-T.ndims_out matrix. 也 ach 
row ofUrepresents apoint in Ts input space, and is the inversetransformation 
of the corresponding row of X. 


IfXxis an (N+l)-dimensional array (including an implicit trailing singleton 
dimension fT.ndims_out is 1), then tforminv applies the transformation to 
each point X(P1,P2,...,PN,:).Size(X,N+1) mustequalT.ndims_in. Uis an 
(N+1l)-dimensional array containing the results of each transformation in 
U(P1,P2,...PN,:).size(U,I) equals size(X;,I) forI = 1,...;Nand 
Size(U;,N+1) equalsT.ndims_in. 


Create an affine transformation that maps the triangle with vertices (0,0)， 
(6,3), (-2,5) to the triangle with vertices (-1,-1), (0,-10), (-2,5). 


U= [00;63; -2 5]; 
X= [-1 -1;0 -10; 44] 
tform = maketform( ' affine',U,X) 


Validate the mapping by applying tforminv to X. 


tforminv(x,tform) 5 Result should equal U 


cp2tform, tforminv, maketform, f1iptform 


franslate 





Purpose 
Syntax 


Descripfion 


Class Suppor 


Example 


See Also 


Translate structuring element 
SE2 = transJate(SE,V) 


SE2 = reflect(SE,V) translates a structuring element SE in N-D space. V is 
an N-element vector containing the offsets of the desired translation in each 
dimension. 


SE and SE2 are STREL objects; V is a vector of double precision values. 


Dilating with atranslated version of strel(1) is a way to translate the input 
image in space. This example translates the cameraman.tif image down and 
to the right by 25 pixels. 


II = imnread( cameraman.tif ' ) ; 

Se = translate(Sstrel(1)，[25 25]) ; 

J = imdilate(I,Se) 
Imshow(I)，title('original ) 
figure，imshow(J)，title( Translated ' ) ; 





Strel, reflect 


14-363 


fruesize 





PurPpose 


Syntax 


Descripfion 


Remarks 


See Also 
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Adjust qisplay size of an image 


truesize(fig,[mrows mcols]) 
truesize(fig) 


truesize(fig,[mrows ncols]) adjusts the display size of an image. fig 

is a figure containing a single image or a single image with a colorbar. 
[mrows ncols] is a 1-by-2 vector that specifies the requested screen area in 
pixels that the image should occupy. 


truesize(fig) uses the image height and width for [mrows ncols]. This 
results in the display having one Screen pixel for each image pixel. 


I 节 you omit the fgure argument, truesize works on the current 下 gure. 


Ifthe'TruesizeWarning' toolbox preference is 'on' ,truesize displays a 
warmning 这 the image is too large to fit on the screen. (The entire image is still 
displayed, but at less than true size.) If 'TruesizeWarning ' is 'off' ,truesize 
does not display the warning. Note thatthis preference applies even when you 
call truesize indirectly, such as through imshow. 


Imshow, IptSsetpref, 1Iptgetpref 


uint8 





Purpose Convert data to unsigned 8-bit integers 


uint8 is a MATLAB built-in fanction. To get help for this function, select 
MATLAB Help from the Help menu and view the online fanction reference 


page. 
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uint16 





PurPpose Convert data to unsigned 16-bit integers 


uint16 is a MATLAB built-in function. To get help for this function, select 
MATLAB Help from the Help menu and view the online function reference 


page. 
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warp 





Purpose 


Syntax 


Descripfion 


Class Suppor 
Remarks 


Example 


Display an image as a texture-mapped surface 


Warp(X,map) 
Warp(I,n) 
Warp(BW) 

Warp (RGB ) 
Warp(z,，...) 
Warp(x,y,Z，...) 
hn = warp(...) 


warp(X,map) displays the indexed image X with colormap map as a texture map 
on a Simple rectangular surface. 


warp(I,n) displays the intensity image I with gray scale colormap of length n 
as a texture map on a simple rectangular surface. 


warp(BW) displays the binary image BW as a texture map on a Simple 
rectangular Surface. 


warp(RGB) displays the RGB image in the array RGB as a texture map on a 
Simple rectangular surface. 


warp(z,...) displays the image on the surface z. 
warp(xiy,z...) displays the image on the surface (xy,z). 


h = warp(...) returns aphandle to atexture mapped surface. 
The input image can be of class logical, uint8, uint16, or doub1le. 
Texture-mapped surfaces generally render more slowly than images. 


This example texture maps an image of atest pattern onto a cylinder. 


[x,y,zZ] = cylLinder; 
II = imnread( ' testpat1.tif ) ; 
Warp(xy， ZI) ; 
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warp 











See Also imshow 


image, imagesc, Surf in the MATLAB Function Reference 
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watershed 





Purpose 


Syntax 


Descripfion 


Find image watershed regions 


L = Watershed(A) 
L = Watershed(A,CONN) 


L = watershed(A) computes a label matrix identifying the watershed regions 
of the input matrix A, which can have any dimension. The elements of L are 
integer values greater than or equal to 0. The elements labeled 0 do not belong 
to a unique watershed region. These are called watersAea pixels. The elements 
labeled 1 belong to the first watershed region, the elements labeled 2 belong to 
the second watershed region, and so on， 


By default, watershed uses 8-connected neighborhoods for 2-D inputs and 
26-connected neighborhoods for 3-D inputs. For higher qimensions, watershed 
uses the connectivity given by conndef(ndims(A) ，maximal ' ). 


L = watershed(A,CONN) specifies the connectivity to be used in the watershed 
computation. CONN may have any ofthe following scalar values. 





Value Meaning 





Two-dimensional connecftivities 
4 4-connected neighborhood 
8 8-connected neighborhood 


Three-dimensional connecftivifies 


6 6-connected neighborhood 
18 18-connected neighborhood 
26 26-connected neighborhood 





Connectivity may be defined in a more general way for any dimension by using 
for CONN a 3-by-3-by- .…-by-3 matrix of 0's and 1's.The 1-valued elements define 
Deighborhood locationgs relative to the center element of CONN. Note that CONN 
must be symmetric about its center element. 


14-369 


wdaftershed 





Class Suppor 


Example 
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Acanbe anumeric or logical array of any dimension, and it must be nonsparse. 
The output array Lis ofclass doub1e. 


2-D Example: 


1 Make a binary image containing two overlapping circular objects. 
center1 = -10; 
Center2 = -Center1 
dist = Sqrt(2*(2*Ccenter1)^2) 
radius = dist/2 * 1.4; 
1Lims = [floor(center1-1.2*radius) celil(center2+1.2*radius) ] 
[x,y] = meshgrid(1Lims(1):1ims(2)); 
bw1 = Sqrt((x-center1).^2 + (y-center1).^2) <= radius 
bw2 = Sqrt((x-center2).^2 + (y-Ccenter2).^2) <= radius 
bw = bw1 | bw2; 
figure，imshow(bw, 'n')，title( bw') 


2 Compute the distance transform of the complement of the binary imasge. 
D = bwdist(~bw) ; 
figure，imshow(D,[]，n' )，title('Distance transform of ~bw ) 


3 Complement the distance transform, and force pixels that don't belong to 
the objects to be at - Inf. 


4 Compute the watershed transform and dqisplay it as an indexed image. 


L = Watershed(D) ; 
rgb = label2rgb(L，jet' ,[.5 .5 .5]); 
figure，imshow(rgb,，'n')，title(' Watershed transfrom of D ) ; 


3-D Example: 


1 Make a 3-D binary image containing two overlapping Spheres. 


Center1 = -10| 

Center2 = -Center1 

dist = Sqrt(3*(2*center1)^2) 

radius = dist/2 * 1.4; 

1Lims = [floor(center1-1.2*radius) celil(center2+1.2*x*radius)]; 
[x,y,z] = meshgrid(lLims(1):1Lims(2) ) ; 


watershed 





bw1 = Sqrt((Xx-center1).^2 + (y-center1).^2 + .,， 
(Z-Ccenter1).^2) <= radius 

bw2 = Sqrt((Xx-center2).^2 + (y-center2).^2 + .,， 
(Z-center2).^2) <= radius; 

bw = bw1 | bw2; 

figure，isosurface(x;y，zbw,0.5)，axis equal，title('BW') 

XJabel X，yJabel yY，Zz]label z 

XlLim(1LIims)，yLlLim(1Limns)，Zzlim(1Lims) 

view(3)，camlight，1ighting gouraud 


2 Compute the distance transform. 
D = bwqdist(~bw) ; 
figure，isosurface(x;y，z，D,radius/2)，axis equal 
title('Isosurface of distance transform ' ) 
XJabel X，yJabel yY，Zz1label z 
Xlim(1LIims)，yLlLim(1Limns)，Zzlim(1Linms) 
view(3)，camlight，1ighting gouraud 


3 Complement the distance transform, force nonobject pixels to be -Inf, and 
then compute the watershed transform 


D(~bw) = -Inf; 

L = Watershed(D) ; 
figure，isosurface(x;y,，zZ,L==2,0.5)，axis equal 
tit1le('Segmented object ') 

XJabel X，yJabel yY，Z]label z 
Xlim(1LIims)，yLlLim(1Limns)，Zzlim(1Linms) 
view(3)，camlight，1ighting gouraud 
figure，isosurface(x,y,，z,L==3,0.5)，axis equal 
tit1le('Segmented object ') 

XJabel X，yJabel yY，Zz]label z 
XlLim(1LIims)，yLlLim(1Limns)，Zzlim(1Linms) 
view(3)，camlight，1ighting gouraud 


Algorithm watershed uses a variation ofthe Vincent and Soille algorithm [J]. For details 
of the variation, see toolbox/images/images/private/watershed vs .h. 


See Also bwlabel, bwlabeln, bwdist, regionprops 
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Reference [1 Luc Vincent and Pierre Soille“Watersheds in Digital Spaces: An 玉 佳 cient 
Algorithm Based on Imnmersion Simulations,”7 五 及 7T7a71sactzo1s of Patter7 
APalysis aa MacAzine 1pztellisemce, vol. 13, no. 6, June 1991, pp. 583-598. 
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Purpose Perform two-dimensional adaptive noise-removal filtering 
Syntax J = Wiener2(I,[m n]l,noise) 
[J,noise]l = Wiener2(I,[mnl]) 
Descripfion wiener2 lowpass filters an intensity image that has been degraded by constant 


power additive noise. wiener2 uses a pixel-wise adaptive Wiener method based 
on statistics estimated from a local neighborhood of each pixel. 


J = wiener2(I,[m n]l,noise) flters the image I using pixel-wise adaptive 

Wiener filtering,using neighborhoods of size m-by-n to estimate the local image 
mean and standard deviation. Ifyou omit the [m_n] argument, m and n default 
to 3. The additive noise (Gaussian white noise) power is assumed to be noise. 


[J,noise] = wiener2(I,[mn]l) alsoestimates theadditive noise power before 
doing the filtering. wiener2 returns this estimate in noise. 


Class Support The input image, I, is a two-dimensional image of class uint8, uint16, or 
double. The output image, J, is ofthe same size and class as 工 . 


Example Degrade and then restore an intengsity image using adaptive Wiener filtering. 


I= imread(' Saturn.tif ' ) ; 

J = imnoise(I，gaussian' ,0;,0.005) ; 
K = Wiener2(J,[5 5]); 

imshow(J) 

figure，imshow(K) 





Algorithm wiener2 estimates the local mean and variance around each pixel 
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WwWiener2 





See Also 


Reference 
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1 72 E 站 
元 条 汉 Q (1,72) 一 几 
71 72E M 


wheremis the N-by-M local neighborhood of each pixel in the image A. wiener2 
then creates a pixel-wise Wiener filter using these estimates 


G2_Vv” 
本 (4(21,72) 一 几 ) 
C 





(21,72) = 凡 十 


where v2 is the noise variance. Ifthe noise variance is not given, wiener2 uses 
the average of all the local estimated variances. 


filter2, medfilt2 


[Lim, Jae S. 7Tzo-Dimazemsiozal Sis7al aa 1711rase Processi115. Englewood 
Cliffs, NJ: Prentice Hall, 1990. pp. 536-540. 


ycbcr2rgb 





Purpose 


Syntax 


Descripfion 


Class Suppor 


See Also 


Convert YCbCr values to RGB color space 


rgbmap = ycbcr2rgb(ycbcrmap ) 
RGB = ycbcr2rgb(YCBCR ) 


rgbmap = ycbcr2rgb(ycbcrmap) converts the YCbcCr values in the colormap 
ycbcrmap to the RGB color space. Ifycbcrmap is m-by-3 and contains the YCbCr 
luminance (了 ) and chrominance (C and Cr7) color values as columns, then 
rgbmap is returned as an m-by-3 matrix that contains the red, green, and blue 
values equivalent to those colors. 


RGB = ycbcr2rgb(YCBCR) converts the YCbCr image YCBCR to the equivalent 
truecolor image RGB. 


Ifthe input is aYCbcCr image, it can be of class uint8, uint16, or double; the 
output image is ofthe same class as the input image. Ifthe input is a colormap， 


the input and output colormaps are both of class doub1le. 


ntSsc2rgb, rgb2ntsc, rgb2ycbcr 
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ZOoOIm 





Purpose Zoom in and out on an image 


zoomis a MATLAB function. To get help forthis function, select MATLAB Help 
位 om the Help menu and view the online fanction reference page. 
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Numerics 

16-bit image files 2-16, 2-18 
1-bit image files 3-8 

24-bit image files 2-8 

4-bit image files 2-17 

8-bit image files 2-16, 2-18 


人 
adaptive filtering 14-373 
adaptive filters 10-23 
definition 10-2 
addition 
of images 2-23 
affine transformation 
definition 5-13 
affine transformations 4-12 
aliasing 4-6 
definition 4-2 
alpha channel 13-4 
analyzing images 
edge detection 14-119 
histogramsgs 14-225 
intengsity profiles 14-246 
pixel values 14-243 
duadtree decomposition 14-317 
anti-aliasing 4-6, 14-256 
definition 4-2 
applLylLut 9-53, 14-21 
example 9-54 
approximation 
definition 13-2 
of an image background 1-9 
area 
of binary images 9-51, 14-28 
of image regions 10-9 
arTayS 





storing images 2-4 
averaging filter 7-7, 14-139 


B 

background 
of a binary image 9-2 
of an intensity image 1-9 

bestb1lk 14-23 

bicubic interpolation 4-3 
definition 4-2 

bilinear interpolation 4-3 
definition 4-2 

binary image operationg 
connected-components labeling 14-46 
food fi]] 14-41 
lookup-table operationgs 14-21, 14-287 
morphological operations 14-52 
neighborhoods 14-21 

binary images 2-8, 14-280 
changing the display colors of 3-7 
connected-components labeling 9-49 
converting 位 om other types 14-171 
definition 2-2 
displaying 3-6 
Euler number 9-52, 14-39 
feature measurement 9-49 
food 丰 ]] operation 9-26 
Image area 9-51, 14-28 
lookup table operations 9-53 
Imorphological operations 9-4 
object selection 14-60 
packing 9-3 
perimeter determination 9-17, 14-58 
selecting objects in 9-51 

binary masks 11-3 
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工 -2 


definition 11-2 

demo that creates XXiii 
bit depth 

1-bit images 3-8 

Screen bit depth 13-3 
blind deconvolution algorithm 

demo XXi 

used for deblurring 12-14 
blkproc 6-9, 14-24 

exXample 6-10, 6-11 

ee also dctdemo and ipss003 
block operations 

definition 6-2 
block processing 6-2 

block size 14-23 

column processing 6-12 

distinct blocks 6-9, 14-24 

padding bordqers 6-6 

sliding neighborhoodqds 6-5, 14-302 
BMP 2-16 
border padding 6-6 

definition 6-2 
border replication 

in image processing 7-12 
boundary padding 

ee border padding 
boundary ringing 

in image deblurring 12-20 
bounding box 

defining regions in images 1-20 

finding for a region 10-9 
brightness adjustment 10-15 

demo of xxi 

心 ee also imadjust 
bwarea 9-51, 14-28 
bwareaopen 14-30 
bwdist 14-33 


bwdist 9-38 
bweuler 14-39 
bwfil11 14-41 
bwhitmiss 14-44 
bwlabel 14-46 
bwlabeln 14-49 
bwmorph 14-52 
skeletonization example 9-17 
bwpack 14-56 
bwperim 14-58 
bwselect 14-60 
bwulterode 14-62 
bwunpack 14-64 


C 


camera read-out noise 12-11 
cancer cell demo Xxii 
Canny edge detector 10-10, 14-120 
center of mass 

calculating for region 10-9 
center pixel 

calculating 6-5 

definition 6-2 
checkerboard 14-65 
chrominance 

in NTSC color space 13-15 

in YCbCr color space 13-16 
class Support 2-12 

See also data types 
closing 14-52 

morphology 9-14 
closing an image 

demo xxii 
cmpermute 14-67 
cmunique 14-68 
col2im 14-69 
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colfilt 6-12, 14-70 
example 6-13, 6-15 
Color 
approximation 13-7, 14-117, 14-183, 14-334 
dithering 13-13, 14-117 
duantization 13-7, 14-334 
reducing number of colors 13-6 
color approximation 
definition 3-2 
color cube 
a description of 13-7 
quantization of 13-8 
color planes 13-9, 13-18 
of an HSV image 13-18, 13-19 
of an RGB image 2-9 
color reduction 13-6--13-14 
color Spaces 
converting between 2-14, 13-15, 14-305, 14-336， 
14-337, 14-375 
HSV 13-17 
NTSC 13-15, 14-305, 14-336 
RGB 13-15 
YCbCr 13-16, 14-337, 14-375 
colorbar 3-12 
example 3-12 
colorcube 13-12 
colormap (matrix) 
creating a colormap using colorcube 13-12 
colormap mapping 13-11 
colormaps 
brightening 14-27 
darkening 14-27 
rearranging colors in 14-67 
removing duplicate entries in 14-68 
column processing 14-70 
definition 6-2 
in neighborhood operations 6-12 


reshaping blocks into columns 14-173 
reshaping columns into blocks 14-69 
composite transformations 4-12 
concatenation 
used to display intensity as RGB 3-20 
conformal mapping 
demo XXi 
conformal transformations 5-13 
conndef 14-73 
connected component 
definition 9-2 
connected-components labeling 9-49, 14-46 
demo of xxii 
connectivity 
definition 9-2 
OverView 9-23 
specifying custom 9-25 
constant component 
ee zero-frequency component 
contour plots 10-8, 14-195 
text labels 10-8 
contouTSs 
definition 10-2 
contrast adjustment 
decreasing contrast 10-15 
demo of xxi 
increasing contrast 10-14 
specifying limits automatically 10-16 
心 ee also imadjust 
contrast stretching 
See contrast adjustment 
Control Point Selection Tool 
appearance of control point symbols 5-27 
changing view of images 5-18 
Saving a Session 5-31 
saving control points 5-30 
specifying control points 5-22 
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工 4 


starting 5-16 

Using 5-15 

Using point prediction 5-25 
control points 

appearance of 5-27 

prediction 5-25 

saving 5-30 

selecting 5-15 

specifying 5-22 
conv2 2-15 
Conv2 

compared to imfilter 7-14 
conversions between image types 2-12 
convmtx2 14-76 
convn 2-15 
convn 

compared to imfilter 7-14 
convolution 

convolution matrix 14-76 

definition 7-4 

Fourier transform and 8-12 

two-dqimensional 7-4 

with imfilter 7-9 
convolution kernel 

definition 7-4 
coordinate Systems 

Pixel coordinates 2-28 

spatial coordinates 2-29 
corr2 10-9, 14-78 
Correlation 

definition 7-6 

Fourier transform 8-13 

with imfilter 7-9 
correlation coefGcient 14-78 
correlation kernel 

definition 7-6 
cp2tform 14-79 


cp2tform 
Using 5-13 
cpcorr 14-88 
cpcorr 
example 5-33 
cpselect 14-90 
Cpselect 
ee also ipexregaerial demo 
using 5-8 
cpstruct2pairs 14-92 
cropping an image 4-10, 14-197 
crosS-correlation 
demo xxi 
fne-tuning control point selection 5-10 
improving control point selection 5-33 


D 
damping 

for noise reduction 12-10 
data types 

8-bit integers (uint8) 2-4 


converting between 14-118, 14-178, 14-179， 


14-204, 14-238, 14-262 


double-precision (doub1le) 2-4, 14-118, 14-178， 


14-179, 14-204, 14-238, 14-262 
in image fltering 7-7 


summary of imnage types and numeric classes 


DC component 

心 ee zero-frequency component 
dconvreg 14-103 
DCT image compression 

demo of xx 
dct2 8-16, 14-93 

心 ee also dctdemo 
dctdemo demo application XX 
dctmtx 8-17, 14-96 
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ee alLso dctdemo 
deblurring 

avoiding boundary ringing 12-20 

conceptual model 12-3 

OverView 12-3 

OverView of fanctions 12-5 

use of frequency domain 12-19 

using the blind deconvolution algorithm 12-14 

using the Lucy-Richardson algorithm 12-9 

with regularized filter 12-8 

with the Wiener filter 12-6 
deblurring demos xxXi 
decomposition 

getting sequence 14-160 
deconvb1lind 14-97 
deconvb1lind 

example 12-14 

心 ee also ipexdeconvb1lind demo 
deconvlucy 14-100 
deconvlLucy 

example 12-9 

ee also ipexdeconvlucy demo 
deconvreg 

example 12-8 

gee also ipexdeconvreg demo 
deconvwnr 14-105 
deconvwnr 

example 12-6 

心 ee also ipexdeconvwnr demo 
demos XX-XXiii 

list of ?2--XXiii 

location of XX 

running XX 
detail rectangle 

in Control Point Selection Tool 5-17 
dicominfo 14-107 
dicomread 14-108 


dicomwrite 14-111 
dilate 14-115 
dilation 9-4, 14-53, 14-115 
grayscale 14-306 
discrete cosine transform 8-16, 14-93 
Image compresslion 8-18 
Inverse 14-168 
transform matrix 8-17, 14-96 
discrete Fourier transform 8-8 
discrete transform 
definition 8-2 
display dqepth 13-3 
心 ee Screen bit depth 
ee Screen color resolution 
display techniques 14-260 
displaying at true size 14-364 
multiple images 14-355 
texture mapping 14-367 
displaying images 
adding a colorbar 3-12 
at true Size 3-24 
binary 3-6 
binary images with different colors 3-7 
directly from disk 3-11 
indexed images 3-3 
intenslity Images 3-4 
multiframe images 3-13 
multiple images 3-17 
texture mapping 3-28 
toolbox preferences for 
ee preferences 
troubleshooting for 3-30 
unconventional ranges of data 3-5 
Zooming 3-26 
distance 
between pixels 10-3 
Euclidean 10-3 
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distance transform 9-38 Euler number 9-52, 14-39 
distinct block operations 6-9 
definition 6-2 


overlap 6-10, 14-24 F 
Zero padding 6-9 fan beam projections 8-28 
dither 14-117 fast Fourier transform 8-8 
dithering 13-13, 14-117, 14-334 higher-dimensional 14-128 
example 13-13 higher-dimensional inverse 14-170 
division two-dimensional 14-127 
of images 2-27 zero padding 8-10 
double 2-19, 14-179, 14-193, 14-204, 14-235， feature measurement 14-212 
14-238, 14-262 area 10-9 


binary images 9-49 
bounding box 1-20, 10-9 


E center of mass 10-9 
edge 10-10, 14-119 feature measurements 1-18 
example 10-10 feature-based logic 
ee also edgedemo demo of xxii 
edge detection 10-10 fft 8-8 
Canny method 10-10 fft2 2-15, 8-8, 14-127 
demo of XX example 8-9, 8-11 
example 10-10 fftn 2-15,， 8-8 
methodqs 14-119 fftshift 
Sobel method 10-10 example 7-17, 8-11 
edgedemo demo application XX 和 le formats 
edges graphics formats 2-16 
definition 10-2 fles 
edgetaper 14-124 displaying images from disk 3-11 
edgetaper 硬 lling a region 11-8 
avoiding boundary ringing 12-20 definition 11-2 
enhancing images demo of xxiii 
intensity adqjustment 10-14, 14-180 和 lling holes in images 9-28 
noise removal 10-20 flter design 7-16 
erode 14-125 frequency sampling method 7-18, 14-136 
eroslion 9-4, 14-53, 14-125 frequency transformation method 7-17, 14-144 
grayscale 14-306 windowing method 7-19, 14-147, 14-151 


Euclidean distance 10-3, 14-315 filter2 
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compared to imfilter 7-14 
example 3-5, 3-12, 10-22 


和 ltering 


a region 11-6 
masked filtering 11-6 
regions 11-2 


在]ters 


adaptive 10-23, 14-373 

averaging 14-139 

binary masks 11-6 

designing 7-16 

finite imnpulse response (FIR) 7-16 
位 equency response 7-21, 8-11 
imfilter 7-7 

Infinite Imnpulse Response (IIR) 7-17 
Laplacian of Gaussian 14-139 
linear 7-4 

median 10-21, 14-298 
multidimensional 7-13 
order-statistic 14-306 

predefined types 14-139 

Prewitt 14-139 

regularized demo XXxi 

Sobel 14-139 

unsharp 14-139 

unsharp masking 7-14 


FIR flters 7-16 


demo of xx 
transforming from one-dimensional to 
two-dimensional 7-17 


Fourier transform 8-3 
applicationgs of the Fourier transform 8-11 
centering the zero-frequency coefficient 8-11 
computing frequency response 8-11 
convolution and 8-12 
correlation 8-13 
DFT coefficients 8-9 
examples of transform on Simple shapes 8-7 
fast convolution with 8-12 
for performing correlation 8-13 
frequency domain 8-3 
higher-dimensional 14-128 
higher-dimensional inverse 14-170 
increasing resolution 8-10 
padding before computation 8-10 
two-dimnensional 8-3,， 14-127 
Zero-frequency component 8-3 

freqspace 7-20 
example 7-18, 7-20, 7-21 

frequency domain 8-3 
definition 8-2 

位 equency response 
computing 7-21, 8-11, 14-134 
desired response matrix 7-20 

位 equency sampling method (filter dqesign) 7-18， 

14-136 
位 equency transformation method (filter desigmy) 
7-17, 14-144 

fredqz 

example 7-17 


freqz2 7-21, 8-11, 14-134 
example 7-18, 7-20, 7-22 
See also firdemo 

fsamp2 7-18, 14-136 
example 7-18 


firdemo demo application XX 
fat-field correction 12-10 
food-fill operation 9-26, 14-41 
foreground 

of a binary image 9-2 
fast Fourier transform 

ee also Fourier transform 


心 ee also firdemo 
fspecial 14-139 


Index 





fspecial 


creating predefined filters 7-14 


ftrans2 14-144 
example 7-17 
ee also firdemo 

fwind1 7-19, 14-147 
example 7-20 
ee also firdemo 

fwind2 7-19, 14-151 
ee also firdemo 


C 
gamma correction 10-17 
demo of xxi 
心 ee also imadjust 
Gaussian convolution kernel 
位 equency response of 8-11 
Gaussian flter 14-139 
Gaussian noise 10-23 
geocoded images 5-7 
geometric operations 
cropping 4-10, 14-197 
definition 4-2 
interpolation 4-3 
reslZzling 4-5, 14-256 
rotation 4-8, 14-258 
georegistered images 5-7 
getheight 14-155 
getimage 14-156 
example 3-11 
getneighbors 14-158 
getnhood 14-159 
getsequence 14-160 
granulometry 
demo XXi 
graphics card 13-4 


graphics file formats 
converting 位 om one format to another 2-20 
list of formats Supported by MATLAB 2-16 
See also BMP, HDF, JPG, PCX, PNG, TIFF， 
XWD 
gray2ind 14-161 
grayscale images9eeintensity images 
grayscale morphological operationgs 14-306 
graySlice 14-162 
graythresh 14-163 
thresholding image values 1-14 


H 
HDEF 2-16 
head phantom image 8-29 
histed 14-164 
example 10-20 
increase contrast example 10-18 
ee also imadjdemo and roidemo 
histogram equalization 10-18, 14-164 
demo of xxi 
histograms 10-8, 14-225 
definition 10-2 
demo of xxi 
holes 
和 lling 9-26 
HSV color space 13-17 
color planes of 13-18, 13-19 
hsv2rgb 13-17 
hue 
in HSV color space 13-16 
in NTSC color space 13-15 


| 
idct2 14-168 


Index 





ee also dctdemo 
ifft 8-8 
ifft2 8-8 
ifftn 8-8 
IIR filters 7-17 
im2bw 2-13, 14-171 
im2col 14-173 
ee also dctdemo 
im2doub1le 2-19, 14-174 
example 6-15 
心 ee also dctdemo and ipss003 
im2uint16 2-19, 14-177, 14-177 
im2uint8 2-19, 14-176 
imabsdiff 14-178 
imadjdemo demo application Xxi 
imadjust 10-14, 14-180 
brightening example 10-16 
gamma correction and 10-17 
gamma correction example 10-18 
increase contrast example 10-14, 10-16 
ee awlso imadjdemo, Landsatdemo, roidemo, and 
Ipss003 
image analysigs 
contour plots 10-8 
edge detection 10-10 
histograms 10-8 
intengsity profiles 10-4 
OvervView 10-10 
pixel values 10-3 
duadtree decomposition 10-11 
Summary statlistics 10-9 
image area (binary images) 14-28 
image arithmetic 
combining functions 2-27 
example 9-43 
OVerView 2-21 
truncation rules 2-22 


image editing 11-8 
image filtering 
data types 7-7 
unsharp masking 7-14 
with imfilter 7-7 
image processing 
demos XX--XXiii 
ee alLso demos 
image profiles 
definition 10-2 
Image properties 
definition 10-2 
set by imshow 3-4 
set by imshow for binary images 3-9 
set by imshow for intensity images 3-6 
set by imshow for RGB images 3-10 
image registration 
demo XXxi 
fine-tuning point placement 5-33 
OVelvView 5-4 
procedure 5-4 
selecting control points 5-15 
specifying control point pairs 5-22 
types of transformations 5-13 
using control point prediction 5-25 
image transformationgs 
affine 5-13 
custom 4-12 
demos XXii 
gallery of examples xxii 
local weighted mean 5-14 
piecewise linear 5-14 
polynomial 5-14 
projective 5-14 
SUpported by cp2tform 5-13 
types of 5-13 
Using imtransform 4-12 
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Image types 2-5 


binary 2-8 

converting between 2-12 

indexed 2-5 

intengsity 2-7 

interpolation and 4-4 

multiframe images 2-11 

OVervVievw 2-2 

RGB 2-8 

See also indexed, intensity, binary, RGB， 
multiframe 

Supported by the toolbox 2-5 


Images 


adding 2-23 

analyzing 10-3 

arithmetic operations 2-21 

as 再 andle Graphics objects 1-11 

causes of blurring 12-3 

converting to binary 14-171 

data types 2-4, 14-118, 14-178, 14-179, 14-204， 
14-238, 14-262 

displaying 14-260 

displaying multiple images 3-17, 14-355 

dividing 2-27 

feature measurement 1-18 

和 lling holes in 9-28 

fnding image minima and maxima 9-29 

getting data 位 om axes 14-156 

how MATLAB stores 2-4 

Image types 2-5 

Improving contrast 1-13 

multiplication 2-25 

reducing number of colors 13-6, 14-183 

registering 5-4 

restoring blurred images 12-3 

returning information about 2-18 

sample images 1-2 


statistical analysis of 1-21 
storage classes of 2-4 
Subtraction 2-24 
Viewing as a surface plot 1-10 
imapprox 13-12, 14-183 
example 13-12 
imbothat 14-184 
Imbothat 
example 9-42 
心 ee also ipexsegwatershed demo 
imclearborder 14-186 
imclose 14-189 
ImCc1ose 
心 ee also ipexsegmicro demo 
Usling 9-14 
Imcomp1Lement 
exXample 9-44 
imcontour 10-8, 14-195 
example 10-8 
imcrop 4-10, 14-197 
example 4-10 
imdilate 14-200 
imerode 14-205 
closure example 9-15 
imextendedmax 14-208 
Imextendedmax 
example 9-31 
imextendedmin 14-210 
Imextendedmin 
example 9-45 
imfeature 14-212 
imfil1 14-218 
Imf 工 1 
example 9-28 
imfilter 14-221 
Imf1Ilter 
compared to other filtering functions 7-14 


Index 





convolution option 7-9 
correlation option 7-9 
padding options 7-10 
Using 7-7 
imfinfo 2-18 
example 3-9 
imhist 10-8, 14-225 
example 10-9, 10-15 
ee also imadjdemo 
imhmax 14-227 
imhmin 14-229 
imimposemin 14-231 
Imlincomb 
example 2-27 
immovie 14-237 
example 3-16 
imnoise 10-21, 14-239 
example 10-23 
salt & pepper example 10-22 
See also nrfiltdemo and roidemo 
Imopen 
心 ee also ipexsegmicro demo 
Using 9-14 
impixel 10-3, 14-243 
example 10-4 
improfile 10-4,， 14-246 
example 10-6 
grayscale example 10-5 
imread 2-16 
example for multiframe image 3-14 
imreconstruct 14-250 
Imreconstruct 
example 9-20 
imregionalmax 14-252 
imregmin 14-254 
imresize 4-5, 14-256 
imrotate 14-258 


example 4-5, 4-8 
imshow 3-23, 14-260 
example for binary images 3-6 
example for indexed images 3-3 
example for intensity images 3-4, 3-5 
example for RGB imasges 3-10 
preferences for 3-23 
truesize option 3-25 
imtophat 14-263 
Imtophat 
example 9-42 
心 ee also ipexsegwatershed demo 
imtransform 14-241, 14-265 
Using 4-12 
Imwrite 
example 3-8 
ind2gray 14-272 
ind2rgb 2-13, 14-273 
example 3-20 
indexed images 2-5, 14-283 
converting 位 om intengsity 14-161 
converting 人 om RGB 14-334 
converting to Intengslity 14-272 
converting to RGB 14-273 
definition 2-2 
displayed as intensity image 3-30 
reducing number of colors 13-6 
reducing number of colors in 13-12 
infinite impulse response (IIR) filter 7-17 
inline 6-10 
ee also function functions 
intengsity adjustment 10-14, 14-180 
gamma correction 10-17 
histogram equalization 10-18 
specifying limits automatically 10-16 
ee also contrast adqjustment 
intengsity Images 2-7,， 14-282 
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converting from indexed 14-272 
converting from matrices 14-296 
converting 他 om RGB 14-332 
converting to indexed 14-161 
definition 2-2 

displaying 3-4 

food- 和 1 operation 9-26 


number of gray levels displayed 3-5 


intengsity profiles 10-4, 14-246 
interpolation 4-3 
bicubic 4-3 
definition 4-2 
bilinear 4-3 
definition 4-2 
default 4-4 
definition 4-2 
intengsity profiles 10-4 
nearest nelighbor 4-3 
definition 4-2 
of binary images 4-4 
of indexed images 4-4 
of RGB images 4-4 
tradeoffs between methods 4-3 
within a region of interest 11-8 
inverse Radon transform 8-26, 8-28 
example 8-32 


和 ltered backprojection algorithm 8-28 


inverse transform 
definition 8-2 
ipexconformal demo xxXi 
ipexdeconvb1lind qemo Xxi 
ipexdeconvlLucy demo xxi 
ipexdeconvreg demo XxXi 
ipexdeconvwnr demo xxXi 
ipexgranulometry demo Xxi 
ipexmri demo XXxi 
ipexnormxcorr dqemo xxi 


ipexregaerial dqemo XXi 

ipexrotate dqemo XxXii 

ipexsegce1l1l demo Xxii 

ipexsegwatershed dqemo Xxii 

ipexshear demo Xxii 

ipextform demo XXxii 

ipss001 qdqemo Slideshovw Xxii 

ipss002 qdqemo Slideshovw Xxii 

ipss003 qdemo Slideshovw Xxii 

iptgetpref 3-24, 14-274 

iptsetpref 3-23, 14-275 
example 3-24, 3-25 

iradon 8-26, 14-277 
example 8-26 

isbw 14-280 

isflat 14-281 

isgray 14-282 

isind 14-283 

isrgb 14-284 


J 
JPEG 2-16 
JPEG compression 
discrete cosine transform and 8-18 


L 
label matrix 

creating 9-49 

Viewing as pseudo-color image 1-17, 9-50 
Label2rgb 14-285 
labeling 

connected-components 9-49 

levels of contours 10-8 
Laplacian of Gaussian edge detector 14-120 
Laplacian of Gaussian filter 14-139 


Index 





line detection 8-24 
line segment 

pixel values along 10-4 
linear conformal transformations 5-13 
linear filtering 6-6, 7-4 

convolution 7-4 

filter design 7-16 

FIR filters 7-16 

IIR 和 lters 7-17 

noise removal and 10-21 
local weighted mean transformations 5-14 
lookup table operations 9-53 
lookup-table operations 14-287 
Lucy-Richardson algorithm 

demo XXi 

used for dqeblurring 12-9 
luminance 

in NTSC color space 13-15 

in YCbCr color space 13-16 


NM 
magsnifying 
心 ee reslzing images 
makelut 9-53,， 14-287 
example 9-53 
marker controlled watershed segmentation 
example 9-41 
marker Image 
creating 9-35 
definition 9-19 
mask image 
definition 9-19 
masked fltering 11-6, 14-342 
definition 11-2 
mat2gray 2-13, 14-296 
Imatrlices 


converting to intensity images 14-296 
storing Images in 2-4 
Imaxima 
fndqing in images 9-29 
imposing 9-34 
SuUppressing 9-32 
MecClellan transform 14-144 
mean2 10-9, 14-297 
medfilt2 10-21, 14-298 
example 10-22 
ee also nrfiltdemo and roidemo 
median filtering 10-21, 14-298 
minima 
fndqing in images 9-29 
imposing 9-34 
SuUppressing 9-32 
minimum variance quantization 
See quantization 
MoirkE patterns 4-6 
montage 14-300 
example 3-15 
morphological closing 
demo Xxii 
Imorphological opening 
demo Xxii 
Imorphological operations 9-4, 14-52 
closing 14-52 
diagonal fill 14-53 
dilation 9-4, 14-53, 14-115 
erosion 9-4, 14-53, 14-125 
grayscale 14-306 
opening 14-53 
predefined operations 9-16 
removing Spur pixels 14-53 
shrinking objects 14-53 
Skeletonization 9-17, 14-53 
thickening objects 14-54 
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thinning objects 14-54 
Imorphological reconstruction 
fnding peaks and valleys 9-29 
Overvlew 9-19 
morphology 
closing 9-14 
definition 9-2 
demos XXi 
opening 9-14 
OverView 9-1 
ee also morphological reconstruction 
watershed demo XxXxii 
mouse 
和 lling region of interest in intensity image 
11-8 
getting an intensity profile with 10-3 
returning pixel values with 10-3 
Selecting a polygonal region of interest 11-3 
Imovies 
creating fom images 3-16, 14-237 
playing 3-17 
MRI dqata 
demo XXxi 
multidimensional 和 lters 7-13 
multiframe images 
about 2-11 
definition 2-2 
displaying 3-13, 14-300 
limitations 2-11 
troubleshooting qisplay of 3-30 
multilevel thresholding 14-162 
multiplication 
of images 2-25 


N 


nearest neighbor interpolation 4-3 


definition 4-2 
neighborhood operationsgs 
definition 6-2 
neighborhoods 
binary image operations 14-21 
definition 9-2 
neighborhood operations 6-2 
nlfilter 6-7, 14-302 
example 6-7 
noise 
definition 10-2 
noise amplification 
reducing 12-10 
noise removal 10-20 
adaptive fltering (Weiner) and 10-23 
adding noise 14-239 
demo of xxiii 
Gaussian noise 10-23, 14-239 
grain noise 10-21 
linear fltering and 10-21 
localvar noise 14-239 
median flter and 10-21 
polsson nolse 14-239 
salt and pepper noise 10-21, 14-239 
Speckle noise 14-239 
nonlinear fltering 6-6 
nonuniform illumination 
demo of correcting for Xxii 
normalized cross-correlation 5-33 
demo xxi 
normxcorr2 14-303 
nrfiltdemo qemo application XXxiii 
NTSC color space 13-15, 14-305, 14-336 
ntsc2rgb 13-15, 14-305 


Index 





O 


object selection 14-60 
observed image 
in image registration 5-15 
opening 14-53 
morphology 9-14 
opening an Image 
demo XXii 
optical transfer fanction (OTT) 
definition 12-2 
order-statistic fltering 14-306 
ordfilt2 14-306 
orthonormal matrix 8-18 
orthophoto 
defined 5-7 
orthorectified image 5-7 
OTF 
ee optical transfer function 
otf2psf 14-308 
otf2psf 
use of 12-19 
outliers 10-21 
Overlap 
in block operations 6-2 
in qistinct block operations 6-9 


P 

packed binary image 
definition 9-3 

padarray 14-309 

padding 
demo XXii 

padding borders 
block processing 6-6 
options with imfilter 7-10 

parallel beam projections 8-27 


PCX 2-16 
perimeter determination 14-58 
in binary images 9-17 
phantom 8-29, 14-312 
piecewise linear transformations 5-14 
pixel values 14-243, 14-315 
along a line segment 10-4 
returning using a mouse 10-3 
pixels 
Correcting for bad pixels 12-10 
defining connectivity 9-23 
definition 2-4 
displaying coordinates of 10-3 
卫 uclidean distance between 10-3 
returning coordqinates of 10-3 
Selecting 10-3 
pixval 14-315 
pixval 10-3 
PNG 2-16 
wTiting as 16-bit 2-17 
point mapping 
for image registration 5-4 
point spread fanction 
importance of in deblurring 12-3 
point spread function (PSF) 
definition 12-2 
polygon 
pixels inside 11-3 
selecting a polygonal region of interest 11-3 
polynomial transformations 5-14 
predicting control point locations 
in image registration 5-25 
preferences 
getting values 14-275 
ImshowAxeSsVisible 3-24 
ImshowBorder 3-24 
ImshowTruesize 3-24 
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TrueSizeWarning 3-24 
Prewitt edge detector 14-120 
Prewitt 和 lter 14-139 
profile 10-3 
projections 

fan beam 8-28 

parallel beam 8-27 
projective transformations 4-12, 5-14 
PSF 

ee point Spread function 
psf2otf 14-316 
psf2otf 

use of 12-19 


Q 
dtdecomp 10-11, 14-317 


example 10-12 
心 ee also qtdemo 
qtdemo dqemo application Xxiii 
dtgetb1Lk 14-320 
心 ee also qtdemo 
dtsetb1Lk 14-322 
心 ee also qtdemo 
duadtree decomposition 10-11, 14-317 
definition 10-2 
demo of xxiii 
getting block values 14-320 
setting block values 14-322 
quantization 13-7 
minimum variance quantization 14-334 


trade-offs between using minimum variance 


and uniform quantization methods 
13-11 
uniform quantization 14-334 


R 
radon 8-20, 8-26, 14-323 

example 8-22 
Radon transform 8-20, 14-323 

center pixel 8-22 

detecting lines 8-24 

example 8-29 

inverse 14-277 

inverse 人 Radon transform 8-26 

line detection example 8-24 

of the Shepp-Logan Head phantom 8-30 

relationship to Hough transform 8-24 
rank filtering 10-23 

心 ee also order-statistic filtering 
ratioling 2-27 
read-out noise 

correcting 12-11 
real orthonormal matrix 8-18 
reconstruction 

morphological 9-19 
reference image 

in image registration 5-15 
reflect 14-325 
regcorr 14-131, 14-132, 14-289 
region labelling 9-49 

心 ee connected-components labelling 
region of interest 

based on color or intensity 11-5 

binary masks 11-3 

definition 11-2 

demo of xxiii 

和 lling 11-8, 14-340 

和 ltering 11-6, 14-342 

polygonal 11-3 

selecting 11-3, 11-4, 14-339, 14-344 
region property measurement 10-9 
regional maxima 


Index 





definition 9-3, 9-29 
Imposing 9-34 
SUpDpressing 9-32 
regional minima 
definition 9-3, 9-29 
imposing 9-34 
SUppressing 9-32 
regionprops 10-9, 14-326 
Using 1-18 
regionprops 
example 9-47 
registering an image 5-4 
regularized flter 
demo XXi 
used for dqeblurring 12-8 
replication 
to avoid bordqer effect 7-12 
resizing images 4-5, 14-256 
anti-aliasing 4-6 
resolution 
Screen color resolution 13-3 
See alLso bit depth 
13-3 
RGB color cube 
a description of 13-7 
duantization of 13-8 
RGB images 2-8, 14-284 
converting 位 om indexed 14-273 
converting to indexed 14-334 
converting to intengsity 14-332 
definition 2-3 
displaying 3-10 
intensities of each color plane 10-7 
reducing number of colors 13-6 
rgb2gray 2-14, 14-332 
rgb2hsv 13-17 
example 13-18 


rgb2ind 2-14, 13-7, 14-334 
colormap mapping example 13-12 
example 13-9, 13-10, 13-12, 13-13 
minimum variance quantization example 

13-10 
specifying a colormap to use 13-11 
uniform quantization example 13-9 

rgb2ntsc 13-15, 14-336 
example 13-15 

rgb2ycbcr 13-16 
example 13-16 

Richardson-Lucy algorithm 
ee Lucy-Richardson 

ringing 
in image deblurring 12-20 

Roberts edge detector 14-120 

roicolor 11-5, 14-339 

roidemo demo application Xxiii, 11-3 

roifil1l 11-8, 14-340 
example 11-8 
ee alLso roidemo 

roifilt2 11-6, 14-342 
contrast example 11-6 
inline example 11-6 
心 ee alLso roidemo 

roipoly 11-3, 11-4, 14-344 
example 11-3 
ee alLso roidemo 

rotating an Image 4-8, 14-258 

rotation angle 
demo of findqing xxii 


S 

salt and pepper noise 10-21 
sample images 1-2 
Sampling 
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handling undersampled images 12-11 
Saturation 

in HSV color space 13-16 

in NTSC color space 13-15 
Scale 

demo of fndqing xxii 
Screen bit depth 3-18, 13-3 

definition 13-2 

ee also ScreenDepth property 


Screen color resolution 13-3 
definition 13-2 
ScreenDepth 13-3 
Segmentation 
demo XXii 
Shearing 
demo XXii 
Shepp-Logan head phantom 8-29 
shrinking 
心 ee resiZzing images 
Signal Processing Toolbox 
hamming fanction 7-20 
Skeletonization 9-17 
sliding neighborhood operations 6-5, 14-302 
center pixel in 6-5 
padding in 6-6 
Sobel edge detector 14-119 
Sobel filter 14-139 
spatial coordinates 2-29 
spatial domain 
definition 8-2 
statistical properties 
mean 14-297 
of image objects 1-21 
standard deviation 14-346 
std2 10-9, 14-346 
Storage classes 


converting between 2-19 

of images 2-3 
strel 14-347 
stretchlim 14-353 

adjusting image contrast 1-13 
structuring elements 9-7 

creating 9-8 

decomposition sequence 14-160 

definition 9-3 

determining composition 14-202 
subimage 3-20, 3-21, 14-355 
subp1lot 3-20 
Subtraction 

of images 2-24, 9-43 

of one image from another 1-12 
Sum 2-15 
SUrf 

Viewing images 1-10 


T 

template matching 8-13 
texture mapping 3-28, 14-367 
tform 14-293 

tformarray 14-357 

tformfwd 14-361 

tforminv 14-362 
thresholdqing 


to create a binary image 1-14, 14-171 
to create indexed image from intensity image 


14-162 
TIFF 2-16 
tomography 8-26 
transformation matrix 7-17 
transforms 8-1 
definition 8-2 
discrete cosine 8-16, 14-93 


Index 





discrete Fourier transform 8-8 
Fourier 8-3, 14-127, 14-128 
inverse discrete cosine 14-168 
inverse Fourier 14-170 
inverse Radon 8-26, 14-277 
Radon 8-20, 14-323 
two-dimensional Fourier transform 8-3 
translate 14-363 
transparency 13-4 
troubleshooting 
for display 3-30 
image displays 3-30 
truecolor 13-6 
truesize 3-25, 14-364 
truncation rules 
for image arithmetic operators 2-22 
typographical conventions (table) XiX 


U 
Uint16 
storing Images in 2-4, 2-16 
Uint8 
storing Images in 2-4, 2-16 
undersampling 
correcting 12-11 
uniform quantization 
ee quantization 
unsharp filter 14-139 
demo of xxiii 
unsharp masking 7-14 


W 

warp 3-28, 14-367 
example 3-28 

watershed 14-369 


Watershed 
example 9-46 
watershed demo Xxii 
watershed segmentation 
example 9-41 
weight arTray 
in deblurring 12-10 
Wiener 人 filter 
deblurring with 12-6 
demo XXi 
wWiener2 10-23, 14-373 
example 10-23 
See also nrfiltdemo 
windowing method (filter design) 7-19, 14-147， 
14-151 


六 
X-ray absorption tomography 8-27 


XWD 2-16 


Y 

YCbCr color space 13-16, 14-337, 14-375 
ycbcr2rgb 13-16 

YIQ 13-15 


世 
zero padding 8-12 
and the fast Fourier transform 8-10 
image boundaries 7-10 
Zero-cross edge detector 14-120 
Zero-frequency component 8-3 
Zoom 3-26 
Z00mling 
Control Point Selection Tool 5-20 
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in figure window 3-26 
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